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i, INTRODUZIONE 


Un programma BASIC che utilizzi moduli Assembler deve 
avere la seguente struttura: 












i PROGRAMMA | 
i BASIC 





Fi MODULO 
| ASSEMBLER 









i ASSEMBLER 





| ARGOMENTI 







(TLT {KK {KM 








ASSEMBLER 





Ovvero: 


- il programma BASIC deve poter trasferire ad un mo- 
dulo Assembler alcuni argomenti per ottenerne un'e 
laborazione rapida; 


- il programma BASIC deve poter utilizzare più volte 
lo stesso modulo come pure utilizzare più moduli 
distinti; 


- al termine di ogni modulo utilizzato, il controllo 
ritorna al programma BASIC. 





Un modulo Assembler, per poter essere utilizzato da 
un programma BASIC, deve avere le seguenti caratteri 
stiche: 


-— poter prelevare gli argomenti forniti dal program- 
ma BASIC e, nel caso si tratti di argomenti numeri 
ci, convertirli in formato binario (vedi Appendice 
B) onde renderli elaborabili in ambiente Assem — 
bler (fig. 1-1). 


- elaborare gli argomenti prelevati; 

- poter ritornare al programma BASIC gli argomenti 
elaborati (previa ioro conversione in formato memo 
ria - vedi Appendice B — onde renderli utilizzabi- 
li in ambiente BASIC - fig. 1-2 - nel caso si tratti 


di argomenti numerici). 


"H soggetti specifici di questo manuale saranno pertan 
to: 


- la struttura di un modulo Assembler; 
la creazione di un modulo Assembler; 


— il richiamo di moduli Assembler da programma BA - 
SIC; 


- la messa a punto (debugging) del programma BASIC 
compieto di modulo Assembler. 
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ASSEMBLER 
FLOPPY DISK 


FLOPPY DISK 
UTENTE 











PEZSALIAEA 
LIZLIZLII 
tesse 














Fig. 1-1 Ambiente Assembler. 


Si noti che il Floppy Disk Utente è necessario poichè 
in esso verranno registrati i moduli Assembler che 
saranno successivamente richiamati in ambiente BASIC. 
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a) Sistema a Floppy disk 


Customized 
System 
Floppy Disk 









RETI? i 


Lu dl i 


Customized 
Disk System 


b) Sistema a disco 





Bootstrap sl 
Floppy Disk! #- 


gain e i 








1-4 Fig. 1-2 Ambiente BASIC 


Floppy Disk 


Floppy Disk 


&Gpocams gal 
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Caratteristiche di un 
tri uvvi O LIChe di un 
modulo Assembler 
nico fAsSsempler 


Struttura di una frase 
Assembler 
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2. STRUTTURA DI UN MODULO ASSEMBLER 
i 


Un modulo in linguaggio Assembler può essere prepara 
to (modulo sorgente) sia in ambiente Assembler che BA 


SIC (figg. 1-1, 1-2); può essere creato (modulo ogget- 


to) solo in iis Assembler e può essere messo a pun 
to e gestito esclusivamente in ambiente BASIC. 
L'impiego di un modulo Assembler da parte di un pro- 
gramma BASIC impone pertanto che la struttura del modu 
lo rispetti alcune convenzioni particolari. 

Di seguito verranno dapprima richiamati alcuni [ORTA 
ti sulla strutturà di una frase Assembler, quindi le 
convenzioni per strutturare un modulo Assembler. 


Il formato di una frase Assembler è composto dai se- 
guenti campi: 





Line=num [ nome ] operazione [operandi | [commento] 





dove: 


line-num è un numero compreso tra 1 e 9999 che indi 
ca la linea della frase (ovvero dell'istru 
zione Assembler); 

nome è una espressione alfanumerica, composta 


da 1a8 caratteri, che indica il nome sim 
bolico della frase; 


operazione è un simbolo alfanumerico che indica il co 
dice operativo di una delle istruzioni As 
sembler; 


‘operandi è una espressione alfanumerica che indica 


gli operandi della frase; questo campo può 
assumere formati diversi, dipendenti dal ti 
po di frase, per i quali si rimanda al ma- 
nuale P6066 Linguaggio Assembler (GR. code 
3978440Z); 


Note 


Struttura. di un modulo 
sorgente Assembler 


Uso dei registri 


Q=2 


commento è una espressione alfanumerica che contiene 
delle note alla frase; il numero di caratte 
ri di questo campo è limitato dal solo fat- 
to di poter essere contenuti negli 80 carat 


teri del buffer di riga. 


1. I campi di una frase Assembler devono essere separa- 
ti tra di loro da almeno uno spazio. 
In assenza del campo nome, gli spazi tra line-num e 
operazione devono essere almeno due. 


2, Se la frase Assembler è di tipo "commento"' (caratte 
rizzata cioè dai soli campi line-num e commento),il 
campo line-num deve essere seguito immediatamente 
da uno spazio e dal carattere *. 


Le convenzioni per strutturare un modulo sorgente As- 
sembler riguardano quanto segue: 


- uso dei registri; 

- prologo; 

- prelievo/conversione degli argomenti; 
- elaborazione degli argomenti; 

- conversione/ritorno degli argomenti; 
- epilogo; 

- aree di dati. 


I registri generali 11,12,13,14 (in seguito riferiti 
mnemonicamente tome R11,R12,R13,R14) assumono il se- 
guente significato particolare per il sistema: 


- R11: indirizzo della ZRM; 

- R12: indirizzo della COMAREA; 

- R13: indirizzo dell'AREA LOCALE; 

- R14: indirizzo di rientro al programma BASIC. 


Il loro contenuto non deve pertanto essere modificato 
dal modulo Assembler. Se comunque, per esigenze di 
programmazione, si rendesse indispensabile l' impiego 
di tali registri, si provveda a ripristinarne il con- 
tenuto prima di tornare al programma BASIC... 
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Prologo 


Prelievo degli argomenti 
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Il prologo del modulo sorgente è diverso a seconda che 
si desideri o meno l'allocazione del1' area locale. Per 
"area locale" si intende una porzione di stack disponi 
bile al programmatore per il deposito temporaneo di da 
ti durante l'esecuzione del modulo Assembler. 
Prologo con allocazione di area locale: 





START 


PROC 





Prologo senza allocazione di area locale: 





START 


PROC PROLOG=NO 





Gii argomenti, ovvero i dati numerici © alfanumerici 


che il programma BASIC fa elaborare attraverso il mo'- 
dulo Assembler (vedi Istruzione CALL, cap. 4), vengo 
no prelevati dal modulo stesso attraverso la seguen 
te istruzione: 





GSA Rx,Ry 





dove Rx e Ry indicano un qualunque registro generale. 


A seconda del valcre numerico contenuto in Ry (valore 
che il programmatore deve previamente caricare in Ry), 
in Rx verrà automaticamente caricato l'indirizzo dell! 
argomento corrispondente: 


= se l'argomento è numerico, l'indirizzo in Rx corri- 
sponde realmente all'indirizzo di allocazione dell' 
PITTI OSO Hi aliocazione 
argomento. 


- se l'argomento è alfanumerico, l'indirizzo in Rx 
corrisponde all'indirizzo di un descrittore di 5 
byte, i cui 3 ultimi byte contengono l' indirizzo 
di allocazione dell'argomento: 





Le LL 
CERO D0..I0 


DESCRITTORE ARGOMENTO 








Per prelevare l'indirizzo di allocazione di un ar- 
gomento alfanumerico è pertanto necessario incre- 
mentare di 2 il contenuto di Rx. 


La corrispondenza tra valore di Ry e numero d' ordine 
dell'argomento si ricava dalla formula seguente: 


Ry=a=N-i+1 
dove: 


N = numero totale degli argomenti; 
. numero d'ordine dell'argomento da prelevare. 


Se, ad esempio, si desidera prelevare il quarto (i=4) 
di 15 argomenti disponibili (N=15), in Ry si deve ca- 
ricare il seguente valore: 


Ry = 15 -4+1= 12 
Oltre agli argomenti che compaiono nell' istruzione 


CALL (capitolo 4),il programmatore può prelevare anche 
i seguenti parametri: 


| — indirizzo del nome del modulo Assembler, cari- 


cando il valore N+1 in Ry; 


- numero totale degli argomenti (compreso il nome del 
modulo, quindi N+1) e indirizzo di rientro, ca 
ricando il valore @ in Ry. 
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Conversione degli argo- 
menti numerici 
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CS 


Il numero totale degli argomenti è contenuto nel 
byte più pesante; l'indirizzo di rientro nei re- 


stanti tre byte: 





INDIRIZZO DI RIENTRO 





1 byte 3 byte 





Ry 





- arpomenti diversi da uelli forniti dall'istruzio- 





ne CALL. Per tale tipo di prelievo, si faccia rife 
rimento alla Appendice C. 


Se gli argomenti prelevati sono di tipo numerico e 
si desidera elaborarli, ad esempio, aritmeticamente, 
devono essere convertiti da formato memoria in forma 
to binario per poter essere elaborati. 

La conversione da formato memoria a binario si attua 


in due fasi distinte attraverso le seguenti istruzio 
ni: 


ISTRUZIONE CONVERSIONE 


CMST 
CSBH 


Memoria — ISO 
ISO —» Binario 









Elaborazione degli argo 
menti 


Conversione/ritorno de- 
gli argomenti al pro- 
gramma BASIC 


Esempio: conversione del dato numerico + 20 (in dop- 


pia precisione). 










FORMATO STRUTTURA 
weworta (1) | [5 2[9 alo olo 919 919 olo oe è 
CMST 








Iso (2) [2 513 2139] 
CSBH 
BINARIO (2) 


(1) vedi Appendice B 
(2) vedi P6066 Linguaggio Assembler (GR code 39784407). 


Gli argomenti (eventualmente convertiti in formato bi 
nario, se numerici), vengono elaborati dalle istruzio 
ni Assembler che costituiscono il modula. 


Affinchè il programma BASIC possa riutilizzare gli ar 
gomenti elaborati dal modulo .Assembler, può essere 
necessario (nel caso si tratti di argomenti numerici) 
che questi vengano convertiti in formato memoria. 

La conversione da formato binario a formato memoria 
si attua in tre fasi distinte attraverso le seguenti 
istruzioni: 









CONVERSIONE 





ISTRUZIONE 






Binario —+ISO0 
ISO — DATA 
DATA —» Memoria 


CSD 
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Epilogo 
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Esempio: conversione del dato numerico + 19 (in singo 


la precisione). 









FORMATO CONVERSIONE 







BINARIO (2) 






















MEMORIA (1) 


(1) vedi Appendice B 
(2) vedi P6066 Linguaggio Assembler (GR code 39784407). 


Gli argomenti alfanumerici (stringhe) assumono automa 
ticamente il formato descritto nell'Appendice B. 


L'epilogo contiene le istruzioni necessarie a rientra 


re nel programma BASIC; ovvero: 





PRRET 
ORG *-2 
BR R14 





Si noti il salto al registro R14 (BR R14) dove è con- 
tenuto l'indirizzo di rientro al programma BASIC (ve- 


di paragrafo Uso dei registri). 

L'indirizzo di rientro di ogni chiamata a modulo As 
sembler viene caricato nel registro R14 all'atto del- 
la chiamata stessa. 


Aree di dati 


Come già premesso nel paragrafo "Prologo" è possibile 
allocare nello stack un'area locale, disponibile al 
programmatore per il deposito temporaneo di dati du- 
rante l'esecuzione i del modulo Assembler. 

L'area locale, in quanto non facente parte del pro - 
gramma, viene definita tramite una dummy section {ve- 
di manuale P6066 Linguaggio Assembler - GR Code 
39784402). 
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SEZIONI MODULO ISTRUZIONI MODULO 


PROLOGO Î START 
PROC PROLOG=NO 
BALR 3,6 
USING *,3 
LA 


PRELIEVO E I sa s 
CONVERSIONE pisa 
ARGOMENTI | GSA 6,6 
MUI CAMPO.K'06G° 
MUC CAMPO+1 06), CAMPO 
CMST CAMPO, G(6) 
| C584 HALF, CAMPO+1 6) 
BE 4, ERROR 
TM HALF+ 1,881: 
EC S,PARI 
Cassa 
LH 6, HALF 
DM 7,6,RISUL 
ELABORAZIONE E FINE 
ARGOMENTI PARI MUC ‘RESTO. K'6609” 
LH S.HALF 
MLH 9,DUE 
STH 9,RISUL 
FINE MUI CAMPO,K' 66° 
MUC CAMPO+1(65), CAMPO 
[ C85 EARFO+1, RISUL 
LA 8,6 
CSD CAMPO2, CAMPO+1 
(i 8 (5), CAMPO2 


CONVERSIONE MUI CAMPO,N' 09° 
‘E RITORNO MUC CAMPO0+1 (5), CAMPO 
ARGOMENTI | CES CAMPO+1, RESTO 
LA 8,6 
ES CAMPO2, CAMPO+1 
CDM @(4), CAMPO2 
{ERROR | PRRET 
EPILOGO | PRE 
ER_R14 
DUE DE Hop 
IRdA EQU 14 
CAMPO. DS CL? 
(HALF DS H O 
RISUL DS H 
(RESTO DS H. i 
(CAMPOIZ = DS CLS ! 





Fig. 2-1 Struttura di un modulo Assembler senza al- 
locazione di area locale. 
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SEZIONI MODULO 


PRELIEVO E 
CONVERSIONE 
ARGOMENTI 


ELABORAZIONE 
ARGOMENTI 


CONVERSIONE 
E RITORNO 
ARGOMENTI 


EPILOGO 


DEFINIZIONE 
AREA LOCALE 


ISTRUZIONI MODULO 


- NE 


[ERROR 


: DUE 
iR14 
LOCAL 
0LD43 
CAMPO 
HALF 
RISUL 
RESTO 
CAMPO2 


ENDLOCAL | 


SAMURAI 


START 

PROC 

BRLR 3.0 

USING *,3 
USING LOCAL. 13 


MII CAMPO,.K'Ba' 


MUD CAMPO+1 06), CAMPO 


CMST CRMPO,bW(65}) 

CSBH HALF, CAMPO+1 (6) 
EC 4, ERROK È 
TH HALF+1,4/ 64° 

LA #34 

LH 6, HALF 

DM P,6,RISUL 

B FINE 

MUC RESTO, &'/B06000* 

LH S, HALF 

MLH 3, DUE 

STH 9,RISUL 

MUI CAMPO,K'00' 

MUC CAMPO+41 (6), CAMPO 
CBS CRMPO+1, RISUL 
LA H,5 

C5D CRMPO2, CAMPO+1 
CDA 905), CAMPOZ2 

MUI CRIMPO,K'GA' 

MUC CRMPO+1(61), CAMPO 
CES CAMPO+1,RESTO 
LA 8,5 

CSO CAMPO2, CAMPO+1 
COM #04), CAMIPOZ 


PRRET 
URG *-2 
GR RIS 
DC H'2° 
ERU 1% 
DSECT DUMMY SELTION 
DS F 
GS CL? 
DS H 
DS H 
CS H 
DS CLE 
lata 


5 


Fig. 2-2 Struttura di un modulo Assembler con allo- 


cazione di area locale 
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Preparazione del modulo 


sorgente 
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3. CREAZIONE DI UN MODULO ASSEMBLER 


La creazione di un modulo Assembler si articola in 
due fasi distinte: 


- preparazione del modulo sorgente; 
— preparazione del modulo oggetto. 


Il modulo sorgente deve essere un file di tipo testo 


scritto in linguaggio Assembler. 

Il modulo sorgente può anche risiedere su più file te 
sto; in tal caso, esso conterrà solamente i riferimen 
ti ai file testo che lo compongono e che non devono 
comunque superare il numero di 16, 

Esempio: 


19 COPY FILEG 
20 COPY FILEIl 


E max. 16 file 


109 COPY FILEF 


dove  FILEJ, FILE1 ... FILEF sono i nomi dei file te- 
sto che contengono le istruzioni Assembler del modulo 
sorgente. 7 

La procedura per la preparazione del modulo sorgente 
è la seguente: 


- accendere il sistema; 


- inserire il floppy disk Assembler o BASIC ed atten 
dere che il messaggio READY compaia sul display; 


- introdurre il comando TEXT, digitando in tastiera 
le lettere TEX e premendo successivamente il tasto 
EOL; 


- introdurre il modulo sorgente, frase per frase, ri 
spettando il formato della frase stessa (vedi 
Struttura di una frase Assembler, capitolo 2); 





Note 


salvare eventualmente il modulo sorgente (si veda 
la sintassi del comando SAVE, capitolo 6). 


. Nel caso di modulo sorgente composto da più file , 


i file componenti non devono mai contenere l'istru 
zione END di fine assemblaggio. Opzionalmente, la 
istruzione END può essere contenuta nell'ultimo fi. 
le. L'opzionalità dell'istruzione END è valida an 
che per moduli sorgenti composti da un unico file. 


La preparazione del file testo che sono componenti 
di un modulo sorgente richiede il salvataggio di 
tutti i file componenti, onde poterli richiama- 
re durante l'assemblaggio. 


Nel modulo sorgente non devono comparire richiami 
a simboli esterni (vedi manuale P6066 Linguaggio 
Assembler - GR code 397844027); è quindi vietato lo 
impiego dell'istruzione CALEXT. 


Se si desidera il listing del modulo sorgente du- 
rante la sua preparazione, premere il tasto di con 


sole che si illumina, 
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FILE BIN 

5019 STREET 

aGzo PROC 

qaza BALR 3,8 

G04O USING #,3 

4050 USING LOCAL,13 

GIEG LA 4,1 

Gore GSA 4,4 

Gasa LA 5,2 

do9do GSA 5,5 

0198 MUC IS0+1(3),2C85] 

9116 NUI ISO,X' 606° 

Q1za L 5.,ISD 

1139 ALRI 5,2 

1148 LA 7,9 

9158 LA 6,8 

1158 LOOP EGU * 

91720 SUL 2,1 

G150 CLI G05),X'30° 

9198 BE RUANTI 

G206 ALRI 7,1 

AZIO AVANTI ALRI 5.1 

4226 BCT 6,L0OP 

a736 STH P.HALF 
Ba24g LA 9.64 

a250 CES ISO(3), HALF 

49260 C5D DATA, ISO 

6770 CDM 64), DATA 

az54 PRRET 

ozIo ORG *-2 

aZ3ao ER 14 

9318 LOCAL DSECT 

320 OLDR413 05 F 

6336 HALF. DS H 

9348 ISO GS CLa 

4356 DATA DS CLS 

8369 ENDLOCAL DS @F 


END NF LISTINO 


bENilfiesiteatste a: bol __________ reca 


Fig. 3-1 Esempio di listing di un modulo sorgente. 
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Preparazione del modulo 
oggetto 


Il modulo sorgente preparato secondo la procedura pre 
cedentemente descritta, viene trasformato in modulo 
oggetto rilocabile tramite il programma di utilità 
ASM. 

Questo programma attiva l'assemblatore il quale, per 
svolgere le proprie funzioni, necessita temporaneamen 
te di spazio su floppy disk. 

Tale spazio, detto scratch file, è allocato, utilizza 
to e deallocato automaticamente dall'assemblatore:vie 
ne allocato su floppy disk sistema attribuendogli il 
nome QWORK] e viene deallocato al termine dell'assem 
blagpio. 

Se, per qualch: caso accidentale (errore fisico,power 
off), lo scratch file rimane su floppy disk, è bene 
operare in uno dei seguenti modi: 


1) eseguire un successivo passo di assemblaggio che 
cancella automaticamente lo scratch file preesi- 
stente; 


2) copiare la libreria, a cui lo scratch file appar - 
tiene, su di un altro floppy disk; in questa opera 
zione lo scratch file spurio non viene trasferito 
e si evita, nelle successive operazioni, di trovar 
si in presenza di spazio insufficiente su FDU. 


Se non esiste spazio sufficiente ad allocare lo scratch 
file, il sistema segnala errore (vedi Appendice A) e 
l'utente deve. indicare un'altra unità o creare spa 
zio sul floppy disk in questione; lo spazio minimo ri 
chiesto per lo scratch'file è di due settori. 
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Programma di utilità ASM Il programma di utilità ASM traduce un modulo sorgente 
scritto in linguaggio Assembler in modulo oggetto rilo 
cabile. 


Formato 


/ 
FDUT 


EXE [c] ASM, IN=fi Lename; [, (,{F0,,})],0uT= fi tename,[, (.{FDU"})] [LIST], 
fe pas E0}]] 





dove: 


AN falenano, indica il file testo contenente il mo- 
dulo sorgente da assemblare, oppure 
il file testo contenente i riferimenti 
ai file che contengono consecutivamen- 
te il modulo sorgente; 


ORE=Ettenane, indica il file, di tipo oggetto riloca 
bile, su cui viene trasferito l'output 
dell'assemblatore; 


OUT=/ indica che l'output dell' assemblatore 
non viene registrato su floppy disk; 


LIST indica la richiesta del listing del mo 
dulo oggetto; 


XREF indica la richiesta delle cross refe 
. rences in output (vedi paragrafo Esem- ‘ 
pio di output dell'assemblatore);- 


 WSP indica la richiesta dello scratch file, 
Se non specificato, il file viene u- 
gualmente riservato dall' assemblatore 
su floppy disk sistema; 


FDU1/FDU2 indica l'unità su cui risiede l'ogget- 
to del relativo parametro (filename, ; 
filename _, scratch file). Se non speci 
ficato, si opera su floppy disk siste- 
ma. 


Gli operandi sopra descritti sono posizionali. 
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Azione 


Note 


Il programma di utilità traduce un modulo scritto in 
linguaggio Assembler sorgente, residente quale file di 
tipo testo di nome filenamel su floppy disk, in un mo 
dulo oggetto rilocabile; l'output del programma di u- 
tilità è un file di tipo oggetto rilocabile di nome 
filename?2. 

Se, durante l'esecuzione del programma di utilità, si 
verificano situazioni di errore, il sistema segnala 
il messaggio relativo (vedi Appendice A) e passa nel- 
lo stato comandi. Se l'assemblatore rileva nel pro -— 
‘gramma sorgente degli errori, emette delle segnalazio 
ni diagnostiche (vedi Appendice A). 


1. Nei seguenti casi: 


- se filenamel non esiste oppure non è di tipo te 
sto; 


- se le direttive contenute in filenamel fanno Pi 
ferimento ad un file che non esiste oppure che 
non è di tipo testo; 


- se il numero dei file riferiti nelle diretti- 
ve di filenamelt è maggiore di 16; 


il sistema interrompe l'esecuzione del programma 
di utilità ASM e segnala l'errore relativo. 


2. Se filename? esiste già, il sistema controlla se è 
di'tipo oggetto rilocabile; in caso affermativo, 
dato che si presume essere un riassemblaggio dello 
stesso programma, il file viene rimpiazzato; in ca 
so contrario viene segnalato errore (vedi Appendi- 
ce A). 


3. Il file di tipo oggetto prodotto dall'assemblatore 
deve essere allocato su un solo extent. Per con- 
trollare che questa esigenza venga rispettata, si 
utilizzi il comando CATALOG (capitolo 6) dopo l'as 
semblaggio. 

Nel caso risulti che il modulo oggetto risieda su 
più di un extent, procedere in uno dei seguenti mo 
di: 


- eseguire il programma di utilità EXEC LIBCOPY 
{in ambiente BASIC), oppure: 
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= riassemblare il modulo sorgente su di un nuovo 
. floppy disk. 


4, L'operando WSP si utilizza per forzare l'allocazio 
ne dello scratoh file su un floppy disk desiderato. 


5. La fase di assemblaggio può essere interrotta in 
qualunque istante premendo il tasto 


Esempio di output dello L'esempio seguente illustra come viene documentata dal 
assemblatore l'assemblatore l'esecuzione del programma: di utili 


tà ASM. Il modulo sorgente riferito nell'esempio è il 
file testo di fig. 3-3, 
L'assemblatore documenta sempre in stampa le seguen- 


ti informazioni: 





Opzioni 
PAGE 1 
*## ASSEMBLY OPTIONS »-. DATE :! 2971214 
LIST =YES 
KREF =YES 
OUT = BINI 0 FDU1 3 





dove: . 


LIST indica se è stato richiesto (YES) o no (NO) il 
listing del modulo oggetto; 


XREF indica se è stato richiesto (YES) o no (No) il 
listing delle cross references; 


OUT indica il nome del modulo oggetto e l'unità 
(FDUl/FDU?) destinata a riceverlo. 
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IDATA TIZIA AE TZ TATE EZIO ISRAELI III ARIDI EAT ITA 


PAGE 2 
4a ASSEMBLY OPTIONS **% DATE : 797142214 
SOURCE FILE NAME FROM STM TO ST 
BIN 1 36 


NOOO MM MOTO —'’_—_————__————— m_u‘m@t@ouu”9r—&—m—ù 
dove: 


SOURCE FILE NAME indica il nome del modulo sorgente o 
i nomi dei file testo che compongono 
il modulo sorgente (vedi Preparazio- 
ne del modulo sorgente, Capitolo 3); 


FROM STM indica il numero d'ordine della la i 
struzione del modulo sorgente; 


TO STM indica il numero dell'ordine dell'ui 
tima istruzione del modulo sorgente. 
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Dati statistici 


—____——_—_———__r——r'r—————_————@@—@—@—@“@<“< ONION 


HSSEMBLER STATISTICS 


FROGRAM NAME = 
MUMSER OF STATEMENT FLAGGED = & 
HIGHEST SEVERITY WAS @ i 
LINE OBJECT LENGTH = 660660979 
OBJECT MODUL LENGTH = GOSA 
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dove: 


‘ PROGRAM NAME indica l'eventuale nome che accompa- 


gna la prima frase (START) del modu 
lo sorgente; ad esempio BIN START; 


NUMBER OF STATEMENT FLAGGED 
indica il numero di frasi Assembler 
del modulo sorgente che l'assemblato 
re ha riscontrato errate; 


HIGHEST SEVERITY WAS 

: indica il massimo grado di gravità 
di errore (severity code, vedi Segna 
lazioni diagnostiche durante l'assem 
blaggio, Appendice A) riscontrato nel 
modulo sorgente; 


LINK OBJECT LENGTH 
indica in esadecimale 1' occupazione 
di memoria (in byte) del modulo ‘og- 
getto completo di testata (vedi Ap- 
pendice D); 


OBJECT MODUL LENGTH 

indica in esadecimale 1! ocuupazione 
complessiva di memoria (in byte) del 
le istruzioni che compongono il modu 
io oggetto. 

Il numero espresso da OBJECT MODULI 
LENGTH è sempre inferiore di 14 byte 
al numero espresso da LINK OBJECT 
LENGTH (vedi Appendice D). 


Stampe opzionali 


Modulo oggetto 


L'assemblatore può inoltre documentare in stampa opzio 
nalmente (ovvero, soltanto se richiesto con lo specifi 
co parametro LIST o XREF) sia il modulo oggetto che le 
relative cross references. 


SITI ZTAZIARI ZETA ESTADO ISOTTA TELIT RNEMDE SIARIIZNZZENIZI 











ESTERNAL SYNME0L DICTIUNARY 


HO SYMBOL DEFINED 


D 
u 
mi 
in 


LINE LOC DEJECT CADE STMTO SIDECE STATEMENT DRTE lo pa c1219 
gaia auaado START 
Galdi aGagna 2 PROC 
1800 
4109 1019 
FIDO 
Saad Cona 
na3zt uadodoc 0o535 3 GALE 3,0 
nua ° 4 USING *,3 
vaso 5 USING LOCAL ,13 
ARRI BANGGE 4140 0981 2) LB 4.1 
nA7g anaatz 24484 Ta GS5A 4.4 
nasg IAGaR14 4150 GABZ S LA G.Z 
nasa dooadn18 2455 9 G5A 5.5 
G1GG AGAGA1A D202 DO907 5002 14 MID TS0+1 (31, FL5] 
B11d HO0AZ0 IT700 CHA 11 MUI ISOLE‘ Ue 
GB1ID BGGIZ4 SISO DOUBLE 12 L_S:IS0 
1130 0004723 H115 +13 BLRI 5,2 
149 UBGSZA 4179 6000 14 LB P.M 
MADAZE 416560 006I 15 LA 6,5 
16 LOOP EGU * 
Uuunanzz G4d7 Ta SULL 7.1 
Gannz4 9530 SHbo6 n CLI ALS1I;k' 30° 
AII03S 4799 3030 19 GE AUANTI 
noaazo di1d7 vas) 5 ALRI #,1 
GAGGZE GI05 21 RUANTI ALRI 5,1 
HanAsIy 4660 SZ 22 ECT &.L0OF 
Fooan4s sura Dads 23 STH P.HALF 
z Baatss 4100 GUGA za LA BLA 
a259 idag4C DBO2 DIODB DEGS 5 CES ISNC3). HALF 
zi GAAR5Z DIAG DIGA DEU VAS Cab DATA. ISO 
1274 009953 DDGG 4000 DIGA 2° COM #4), DATA 
az5d dooaase 25 FRRET 
Dar 
Adda 
W248 HBAGd6H 253 DRG #2 
GIRA DaRGans GrfE ZH ER 14 
1510 Gaadaa 31 LOCAL DSECT 
ARZi doGdad 32 CLOR13 DS F 
d3350 Aagdaaas di HRLF GS H 
isso GoOagde ZA TI=50 CS CL 
GISA DOAADA 2a DATA GS CLS 
GIbo Nada 14 Ki 





ENGLOCAL DS GF 
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dove: 


EXTERNAL SYMBOL 


LINE 


LOC 


OBJECT CODE 


DICTIONARY NO SYMBOL DEFINED 
indica che nel modulo Assembler non vi 
sono riferimenti a simboli esterni; 


numero di riga delle istruzioni del mo 
dulo sorgente; 


valore dello scostamento in byte del- 
le istruzioni assenblate (tale valore 
è contenuto nel location counter) hi 
spetto all'inizio del modulo oggetto; 


codici esadecimali delle istruzioni. e 
dei loro argomenti, organizzati a grup 
pì di 4 digit. I primi due digit dello 


object code rappresentano sempre il co 


STMT 


SOURCE STATEMENT 


dice operativo dell'istruzione. Gli al 
tri digit assumono significato diverso 
a. seconda del formato dell'istruzione; 
numero d'ordine progressivo delle i - 


struzioni del modulo sorgente; 


istruzioni del modulo sorgente. 
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Cross references 


DIAM ZII III ARIAS III ZELO IETIEAZIIETATIIETTAI 


SYMBOL 


AUARNTI 
GATA 
ENDLOCAL 
HALF 

150 
LOCAL 
LUOP 
GLORAS 


Cl 


DOOR 


RI La 


don 


+. 


Ca 
IS 


i? 


E 
n a 


CROSS REFERENCES 


DEFN 

E 24 
H 35 
36 

4 33 
34 

31 

2 16 
32 


REFERENCES 


tou 


tl 
= RI BI nu 


in a dn di Ji 


LL 


bi RI I LI RIT i 


Ho] 


Priacco o 


CRIAZZIONI AIOSRIRIIOOCAIICANIIIEF TITTI MAIN TIMER ATTRITI EDIT 


dove: 


SYMBOL 


LEN 


VALUE 


DEFN 


- REFERENCES 


nome simbolico; 


simbolico; 


me simbolico; 


occupazione di memoria (in byte) del nome 
valore del location counter relativo al no 


numero d'ordine dell'istruzione ove è sta 
to definito il nome simbolico; i 


numeri d'ordine delle istruzioni che fan- 
no riferimento al nome simbolico. 
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Caratteristiche del pro- 
So veline del pro 
gramma 


Istruzione CALL 


Funzione 


Formato 
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4. RICHIAMO DI MODULI ASSEMBLER DA PROGRAMMA BASTC 
tm mimi ce AMINA BASIC 


Un programma in grado di utilizzare uno o più moduli 


Assembler si differenzia da un normale programma BA 


SIC solo per l'introduzione di una nuova istruzione 
(CALL), che permette di richiamare tali moduli (uno 
alla volta) ovunque occorra. 


| Carica in memoria principale un modulo Assembler e ne 


inizia l'esecuzione. 


CALL string-exp1 Cana HE nc É pes | 
stringrexp 


dove: 


string-exp, è un'espressione stringa il cui valore 
indica il nome di un modulo Assembler 
presente in una delle librerie aperte; 


num-exp è un'espressione numerica il cui valore 
è passato come argomento al modulo As- 
sembler richiamato ; 


string-exp è un'espressione stringa il cui valore 
è passato come argomento al modulo As- 
sembler richiamato ; 


DEB è la stringa omonima e specifica al si- 
stema di caricare il modulo di sistema 
che permette di eseguire il debugging 
del modulo Assembler caricato in memo - 
ria principale. 


Azione 


Note 


L'esecuzione del programma è trasferita all'insieme di 
istruzioni Assembler che costituiscono il modulo ogget 
to il cui nome è specificato da string-exp1l. Il nome 
del modulo viene ricercato su tutte le librerie aperte. 
Se la ricerca ha esito positivo, viene compilata una ta 
bella con l'indirizzo di disco del modulo stesso, In 
tal modo, si evitano ulteriori ricerche in caso di chia 
mata allo stesso modulo. La tabella consente il carica 
mento degli indirizzi di 16 moduli distinti. 

Ogni ulteriore modulo richiamato sostituisce un indi — 
‘rizzo già presente in tabella, a partire dai primi ca- 
ricati. 

Esempio: 





MODULO RICHIAMATO INDIRIZZO CORRISPONDENTE 





170 
18° 
19° 


5e il modulo è reperito sulle librerie aperte, viene 
caricato nell'area di overlay ove permane sino ad una 
nuova occupazione di tale area, o da parte dell'utente 
o del sistema. 


1. Gli argomenti specificati nell'operando 


| num-exp 
: | string-exp sia 


si considerano ordinati in senso crescente da sini- 
stra verso destra, partendo da 1 con incremento di 
Li 

Esempio: 


4% CALI MODUL,A$,C(3,4) ,B$(2) 


AS = 1° argomento 
C(3,4) = 2° argomento 
B$(2) = 3° argomento 


Gli argomenti passati ai modulo Assembler sono cari 
cati. nell'area di stack da cui potranno essere pre- 
levati { vedi Prelievo degli argomenti, capitolo 2). 
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2. 


Il numero di argomenti che si possono passare al mo 
dulo Assembler specificato è limitato solamente dal 
numero di caratteri che possono costituire una i- 
struzione BASIC (80 caratteri). 


Al termine della esecuzione del modulo Assembler , 
viene eseguita l'istruzione esecutiva successiva al 
l'istruzione CALL. 


Se non si specifica l'opzione DEB, è impossibile e- 
seguire operazioni di debugging sul modulo Assem- 
bier, 


5. DEBUGGING DEL PROGRAMMA BASIC COMPLETO DI MODULO 
ASSEMBLEE MODULO, 
ASSEMBLER 











ESEGUIRE IL 
PROGRAMMA 
BASIC 


















COMPLETARE 


i LA CALL CON IL 
i PARAMETRO DEB 








ESEGUIRE IL 
DERUGGING E 
! CORREGGERE IL 
Ì PROG. BASIC 


TIPO DI 
ERRORE © 







ASSEMBLER 










INTERROMPERE 
IL PROGRAMMA |< 
(BREAK) 


ESEGUIRE IL 
DEBUGGING 
i ASSEMBIER (1) 










(1) Questa operazione è possibile 
solo se è stato introdotto il 
comando OPT DEB, 


CORREGGERE E 
RIASSEMBLARE 
IL MODULO 

SORGENTE 








. (2) 
(2) Questa operazione deve essere , 


eseguita in ambiente Assembler 
( fig. 171), 








Fig. 5-1 Procedura di debugging di modulo Assembler. 
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Note 


Come accedere allo sta- 


to debugging 


1. Il tipo di errore (BASIC/ASSEMBLER) viene evidenzia 
to da dicitura specifica: per gli errori di tipo BA 
SIC, ci si riferisca al Manuale Generale P6066; per 
gli errori di tipo Assembler, ci si riferisca all'- 
appendice A del presente manuale. 


2. Eseguita l'operazione di debugging ed apportate le 
opportune correzioni al modulo Assembler, per poter 
lo rieseguire è necessario ritrasformarlo in ogget- 
to attraverso le seguenti fasi operative: 


- spegnere la macchina; 


- sostituire un floppy disk Assembler al floppy 
disk BASIC; 


- riaccendere la macchina; 


- riassemblare (vedi Preparazione del modulo ogget 
to, capitolo 3); 


- ritornare in ambiente BASIC (fig. 1-2). 


Il sistema può eseguire programmi sotto il controllo 
del debugging solo se l'opzione OPT DEB è caricata in 
memoria, 

Le routine di debugging sono caricate in memoria, ma 


non sono attivate; vengono attivate quando: 
- si specifica il parametro DEB nella CALL; 


- durante l'esecuzione del programma si preme il ta — 





sto : 
- a fronte di un errore. 
Quando un programma viene eseguito sotto il controllo, 


del modulo di debugging, il suo tempo d'esecuzione vie 
ne aumentato di circa un 20%.’ 


Entrata in stato debugging: il sistema commuta nello 
stato debugging quando; 
- si esegue una CALL col parametro DEB; 


- si rileva un errore durante l'esecuzione di un pro- 
gramma; 


- si incontra un alt indirizzato; 





si preme il tasto di console 


nello stato di debugging, il tasto 


Quando il sistema 
STEP. illuminato. 


è 
di console di è 
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1. Quando si esegue una CALL con il parametro DEB il 
sistema commuta nello stato di debugging. Il tasto 
di console si illumina. 


2. Se, durante l'esecuzione di un modulo Assembler 5 
viene rilevato un errore, l'esecuzione del program 
ma è interrotta, il sistema commuta nello stato di 
debugging e viene visualizzato un appropriato mes — 
saggio di errore sul display, 


3: Quando si preme il tasto di console s l'ese-. 


cuzione di un programma viene interrotta. Il siste- 
ma commuta nello stato di debugging e sul display 
appare il messaggio. Se si preme di nuovo il tasto 
s viene eseguita l' istruzione visualizzata 





e il sistema commuta di nuovo nello stato di debug 
gine. 


4. Per quanto accade al riconoscimento di un ALT INDI- 
RIZZATO si vedano i comandi da tastiera del presen- 
te capitolo. 


Dopo la segnalazione d'errore su display, si può pre — 
mere il tasto [GIG o il tasto E 
terminazione il programma e pone il sistema nello sta- 





che manda in 


LEV 


to comandi. 

Quando si entra in stato debugging, a fronte di un er- 
rore del programma utente, vengono visualizzate su di- 
splay le seguenti informazioni: 


- il valore del program counter 


- l'istruzione corrente (quella che deve essere ese 
guita) 


- il condition code 


nel seguente formato: 


tososna 


*iliiiii* 0000 0000 0000 CC=x 


dove: 

iiiiii “= program counter 

0000 = codice oggetto in esadecimale 
x = valore del condition code. 


Se si verifica un errore durante l'esecuzione di un 
programma utente e non è stato lanciato il comando 
OPT DEB, il sistema segnala l'errore relativo su di» 


splay ed il programma si ferma; l'unico modo per sbloco 


j che manda 





care il sistema è di premere il tasto | 
in terminazione il programma. 





Strumenti dello stato 


debugging 


Comandi da tastiera 


Quando il programma è nello stato di debugging, si pos 
sono ‘utilizzare i seguenti strumenti per ricercare la 
causa degli errori di un programma presente in memo 
ria principale: 


1. Comandi da tastiera; 


2. Tasti di console. 


"Nello stato debugging è possibile introdurre da ta- 


stiera dei comandi che visualizzano o modificano aree 
di memoria e il contenuto dei registri, I comandi ven 
gono introdotti da tastiera, carattere per carattere, 
e ogni linea di comando viene chiusa da tasto E 
La lunghezza della linea di comando non deve superare 
i 32 crtj in caso contrario verrà rifiutata con segna 
lazione acustica. Nel caso in cui il comando introdot 
to risulti sintatticamente scorretto viene data segna 
lazione di comando errato; premendo il tasto 

è possibile riottenere la linea in modo da poterla 
correggere e reintrodurre. 

T comandi che si possono introdurre. in stato debug - 
ging sono i seguenti: 


- display istruzione corrente. 
- display registro 

- modifica registro 

- stampa registri 

- somma un immediato ad un registro 
- display memoria. 

- modifica memoria 

- stampa memoria 

— avanzamento in display 

- modifica program counter 

- alt indirizzato. 


Errori in stato debugging: introducendo i comandi da 


tastiera si può incorrere in errori di introduzione 
che posscno essere così sintetizzati: 


— comando errato, il comando appena introdotto non 
è sintatticamente corretto ; 


- modifica errata: la modifica non è stata eseguita 
correttamente, più precisamente: 
. è stato modificato il campo indirizzo o iìl campo 
indicante il registro 
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+. i campi sono stati introdotti non nello stesso 
‘formato di output 
» sono stati introdotti caratteri non esadecimali. 


A fronte di questi‘ errori il sistema visualizza que — 
sta segnalazione: 


*INCORRECT FORMAT* 


e si mette in attesa dell'intervento dell'operatore ; 
questi, premendo il tasto s PUÒ riottenere il 
comando errato in modo da poterlo correggere e rein - 
trodurre. 

A fronte di un comando specificante un indirizzo fuo- 
ri della memoria, il sistema visualizza questa segna- 
lazione: 


*MEMORY ADDRESSES EXCEEDED" 


e si mette in attesa dell'intervento dell'operatore : 
questi, premendo il tasto » può riottenere il 
comando errato in modo da poterlo correggere e rein- 
trodurre, 

Nel seguito si dà la descrizione funzionale dei coman 
di da tastiera. 


Display istruzione corrente: 


Funzione : visualizza l'istruzione corrente; 
l'istruzione corrente viene pure 
visualizzata ad ogni entrata in 
stato debugging. 


Formato : (EOL) 
Qutput : *iiiiii* 0000 0000 0000 CC=x 
dove: 


ll1lllì = program counter 


0000 = codice oggetto in esade- 
cimale 

x = valore deli condition co- 
de 

CC=** = caratteri alfanumerici 
fissi 


Messaggi di errore: *INCORRECT FORMAT*. 


Display registro: 


Funzione 


Formato 


Output 


‘ Messaggi di errore: 


Modifica registro: 


Funzione 


Formato 


Output : 


Messaggi di errore: 


visualizza, in esadecimale, il con 
tenuto del registro indicato. 


Ry[y] (EOL) 


*Rep.yy* xxxx XXXX 


dove: 

yy = numero del registro richie 
sto 

xxXxx = contenuto, in esadecimale, 


del registro 
*Reg.*= caratteri alfanumerici fis 
si 


#*INCORRECT FORMAT*. 


: viene visualizzato, in esadecima - 


le, il contenuto del registro indi 
cato, con il pointer posizionato 
in ultima colonna. In questa situa 
zione è possibile editare soltanto 
sul campo che indica il contenu- 
to del registro. 

Per rinunciare alla modifica è ne- 
cessario digitare il tasto 


Ry[y]M (EOL) 


*Reg.yy* xXXXxX XXXXx 


dove: 

yy = numero del registro richie 
sto 3 

Xxxx = contenuto, in esadecimale, 


del registro 
*Reg.*= caratteri alfanumerici fis 
si 


#INCORRECT FORMAT*. 
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Stampa registri: 


Funzione 


Formato 


Output 


Messaggi di errore: 


stampa, in esadecimale, il contenu 
to di tutti i registri. 


R (EOL) 


*Reg.00* XXXxXx XXXX ..0... *Rep.12* 
AXKXX XXXX 
*Reg.01* xXXX XXXXx ...... *Reg.13* 
XXXX XXKXX 


*Reg.02* xXxXX XXXX Li00.. *Reg,14* 


KKXX XXXX 
*Reg.03* XXXX XXXX ++. 0.. *Reg.15* 


XXXX XXXX 


dove: 

KXXX = contenuto, in esadecima 
le, del registro 

*Reg.nn* = caratteri alfanumerici 
fissi 

nn = numero del registro 


*INCORRECT FORMAT*, 


Somma immediato a registro: 


Funzione 


Formato 


Output 


Messaggi di errore: 


esegue la somma binaria fra il con 
tenuto di un registro (24 bits me- 
no' significativi) e una costante e 
sadecimale, visualizzando su di- 


splay il risultato. Il contenuto. 
.del registro non viene modificato. 


: Ry[y] + xxxxxx (EOL; 


° XXXXXX. 


dove: 


yy = numero dei registro ri - 
chiesto 

XXXXxx = costante esadecimale (nel 
formato) e risultato del- 
l'operazione (nell! out- 
put). 


*INCORRECT FORMAT*. 


Display memoria: 


Funzione 


Formato 


Output 


Messaggi di errore: 


Modifica memoria: 


Funzione : 


Formato: 


Output: 


Messaggi di errore: 


: visualizza 8 bytes contigui di me 


moria 


dis 


dove: 

iiiiii = indirizzo del primo byte 

KXXX = contenuto, in esadecima- 
le, della memoria 

** = caratteri alfanumerici 


fissi. 


*INCORRECT FORMAT* 
*MEMORY ADDRESSES EXCEEDED* 


visualizza 8 bytes contigui di me 
moria. Il pointer sarà in ultima 
posizione. Dopo tale comando sarà 
possibile editare sul. contenuto 
della memoria ma non sul campo in 
dirizzo. 

Per rinunciare alla modifica è ne 
cessario digitare il tasto . 


iiiiii M (EOL) 


+e» 


*iiiiii* xXXX XXXX XXXX XXXX 
dove: 


iiiiii = indirizzo del primo byte 


XKXXKX = contenuto, in esadecima- 
le, della memoria 

** = caratteri alfanumerici 
fissi 


*INCORRECT FORMAT* 
*MEMORY ADDRESSES EXCEEDED* 
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Stampa memoria: 


Funzione 


Formato 


Output 


Messaggi di errore; 


stampa, in esadecimale, il contenu 
to della memoria per tanti bytes 
quanti sono quelli indicati nel co 
mando, con arrotondamento a 16. 

Se tale parametro è stato omesso î 
viene assunto il valore 16, 


iiiiijii = indirizzo del primo byte 


YYY = numero di bytes da stam- 
pare (in decimale) 

KXXX = contenuto, in esadecima- 
le, della memoria 

** = caratteri alfanumerici 
fissi 


*INCORRECT FORMAT* 
*MEMORY ADDRESSES EXCEEDED* 


Avanzamento in display: (memoria o registro) 


Funzione > 


Formato 3 


Output 


permette di visualizzare il regi- 
stro o i byte successivi a quelli 
appena visti. Questo comando ha ef 


‘ fetto solo dopo una visualizzazio 


ne o un visualizzazione con modi- 
fica. 


N (EOL) 


Esempio: se utilizzato dopo la vi 
sualizzazione di un registro (es. 
R2), provoca la visualizzazione 
del registro successivo (es. R3). 
Il registro successivo a R15 vie- 
ne considerato il registro RY. Se 
utilizzato dopo la visualizzazio— 
ne di memoria, provoca la visua - 
lizzazione degli 8 byte successi 
vi di memoria, 
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Messaggi di errore: 


*INCORRECT FORMAT* 
*MEMORY ADDRESSES EXCEEDED* 


Modifica program counter: 


Funzione 


Formato 


Output 


Messaggi di errore: 


Alt indirizzato: 


Funzione : 


Formato 


modifica il valore del program co 
unter. In pratica opera come un 
branch incondizionato a un' altra 
parte del programma. 


«dd, I CEOL). 


*iiiiii* 0000 0000 0000 CC=x 


iiiiii = program counter modifica 
to 

0000 = codice oggetto in esade- 
cimale 

Xx = valore del condition co- 
de 

CC=** = caratteri alfanumerici 
fissi 


*INCORRECT FORMAT* 
*MEMORY ADDRESSES EXCEEDED*. 


predispone un particolare indiriz 
zo di BREAK-POINT all'interno del 
programma utente, al riconoscimen 
to del quale la debugging viene 
invocata e si entra in stato de- 
bugging. Una nuova impostazione 
rimpiazza il BREAK-POINT preceden 
te. Per. annullare tale BREAK -— 
POINT basta impostare il comando 
OS(EOL). L'indirizzo predisposto 
dovrà essere puntato sul codice 
operativo dell'istruzione, diver- 
samente verrà ignorato, La ricer- 
ca del BREAK-POINT avviene dalla 
istruzione successiva a quella 
corrente. 


iLitii Ss EOL) 
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Comandi da console 
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sirio 


Output : *lliiii* 0000 0000 0000 CC=x 


lliilli = program counter 


0000 = codice oggetto in esadeci 
male 

x = valore del condition code 

CC=** = caratteri alfanumerici 
fissi 


Messaggi di errore: *INCORRECT FORMAT*. 


Tre tasti di console sono papticotarmente utili come 
strumenti di verifica dei programmi: È [= STEPS 






Nel seguito è spiegato il loro impiego e sono dati al- 
cuni suggerimenti che permettono di utilizzare, nello 
stato di debugging, le DEN offerte dai tasti 
di console SF 3 i 





x 


Se, mentre il sistema è nello stato di debugging, è pre 


muto il tasto di console IMSA , riprende l'esecuzio 
ne del programma che è in memoria principale. Il tasto 
COM si illumina quando è premuto mentre il sistema 
è nello stato di debugging. La funzione del tasto è 
attiva solamente quando il sistema si trova nello sta- 
to di debugging. 








Se, mentre il sistema è nello stato di debugging, è pre 


muto il tasto di console s si può eseguire pas 





so a passo (ossia istruzione per istruzione) il pro 


gramma presente in memoria principale. Ogni volta che 
una istruzione del programma è eseguita,il gistema vi- 
sualizza suì display l'istruzione logicamente successi 
va, che specifica quale istruzione del programma sara! 
eseguita alla successiva pressione del tasto 
Dopo di che, ogni volta che si preme il tasto _. 3 
viene eseguita la successiva istruzione (Si ricordi 
che il tasto di console Î j si illumina ogni volta 
che il sistema è nello stato di debugging). 








Il tasto di console ‘# 
il codice ocpetto di ogni istruzione es seguita, nell'or 
dine con cui essa è eseguita. (T1l tasto a 
ceso quando la funzione omonima è attiva). Per utiliz» 
zare la funzione TRACE nello stato di debugging: 


permette di visualizzare 
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| 
Ì 
Ì 
| 
{ 
| 


Uscita dallo stato de- 


bu 
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in 








1. Premere il tasto 





2. Premere il tasto. [SSA 


Come conseguenza, si riprende l'esecuzione del pro- 
gramma e vengono» visualizzati i codici oggetto delle 
istruzioni eseguite. Si noti che non vengono stampa- 
ti i codici delle istruzioni non esecutive, come * o 
DC, e l'esecuzione del programma è realizzata come 
quando la funzione TRACE non è attiva (la funzione 
TRACE può essere attivata anche a run-time. 

Il codice oggetto di ogni istruzione eseguita viene vi 
sualizzato nel seguente formato: 


*iiiili* 0000 0000 0000 CC=x 


dove: 

iiiiii = program counter 

0000 = codice oggetto in esadecimale 
x = valore del condition code 
CC=** = caratteri alfanumerici fissi 


Se si vuole tenere traccia delle visualizzazioni si 
prema il tasto 






«kw che fa stampare tutte le infor 
mazioni visualizzate. 





Quando la funzione del tasto è attiva, la stam 


| pante integrata è inibita. Questa prestazione può es- 


sere utile per risparmiare tempo di stampa e carta. 
Quando la funzione NO PRINT è attiva, il tasto 
è illuminato e in questo caso viene disabilitata la e 
ventuale funzione di PRINT ALL. 





Il tasto 
permette di terminare l' esecuzione di un programma 
e commuta il sistema nello stato comandi. Nello sta- 
to comandi, si può modificare il programma presente in 
memoria principale oppure introdurre un qualsiasi co- 





s premuto nello stato di debugging , 


DS 


mando di sistema. Quando la funzione BREAK è attiva , 


il tasto è illuminato. 





Si può uscire in seguito ad una delle seguenti opera- 
zioni: 


- premendo il tasto 





jin questo caso viene ese 
guita un'istruzione del programma utente, dopo di 
che si ritorna in stato debugging 
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- premendo il tasto IMI :; in questo caso si ri - 
prende l'esecuzione del programma 


- premendo il tasto ; in questo caso si pas- 
sa direttamente alla terminazione del programma. 


Output del debugging I messaggi emessi, durante lo stato di debugging, ven 
gono visualizzati su display a meno di quelli emes- 
si a fronte di comandi di stampa da tastiera (stampa 
-registro e memoria), 

Nel caso che l'utente voglia tenere traccia dei mes - 
che ‘coman- 





saggi emessi, può premere il tasto 
da al sistema di mandare su stampa i messaggi che com- 
paiono sul display. 

Se il sistema ha nella sua configurazione una stampan 
te IPSO oppure un video, la stampa dei messaggi viene 
effettuata sulla stampante integrata o IPSO ‘a secon- 
da di come si è configurato. il sistema (vedi comando 


CONFIGURE). 
Luci di console Le lampadine, in stato debugging hanno il seguente si 
gnificato: 


- luce running: 
. fissa,quando il debugging è in attesa di un co- 
mando 
. pulsante mentre il debugging sta elaborando un co 
mando. 


— luce overflow; 
» accesa,quando si cerca di introdurre da tastiera 
più di 80 crt. 


—- de-grad: 
. Sempre spenta. 


— TRACE/NO PRINT/PRINT ALL: 
. accesa,quando la predisposizione è in atto. 


Si dà di seguito una tabella sintetizzante la situa - 
zione delle lampadine nei vari stati del sistema: 
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. B>14 























STATO OFF 





ESECUZIONE 
PROGRAMMA 


DEBUGGING 





RUNNING 
STEP 
CONTINUE 
BREAK 
CALC.MODE 


o 5. o E 


dove: 

O = luce spenta 
1 = luce accesa 
* 


luce pulsante 
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6. COMANDI DI SISTEMA 


Comandi utilizzabili nel Nel sistema Assembler sono accettati i seguenti coman 
sistema Assembler di del. repertorio BASIC: 


AUTO # 
CATALOG 
CONFIGURE 
DATA 
DCHANGE 
DELETE LINE 
EXEC i 
FETCH 
LDKEYS 

LIST 

OLD 

PURGE 
REPLACE 
RESEQUENCE 
SAVE 

SHIFT 

SPACE 
STKEYS 

TEXT 


Comandi identici in en- I seguenti comandi hanno sintassi e comportamento ‘' i- 
trambi i sistemi i dentici a quelli del sistema BASIC. 


AUTO # 
DATA 
DELETE LINE 
EXEC 

FETCH 
LDKEYS 
LIST 
RESEQUENCE 
SHIFT 
STKEYS 
TEXT 
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Comandi con diverso com Appartengono a questo gruppo i seguenti comandì: OLD, 
portamento nei due si- PURGE., REPLACE, SPAOE,. 





stemi 
COMANDO i COMPORTAMENTO ASSEMBLER i COMPORTAMENTO BASIC 
OLD Il file cui i comandì di riferisco | Il file cui i comandi si rife- 
PURGE no viene ricercato prima su floppy | riscono viene ricercato su tut 
REPLACE disk sistema ‘e quindi su floppy te le librerie aperte. 

disk utente. 
SPACE Viene stampato lo spazio (in byte) Viene stampato lo spazio {in 


disponibile sui floppy disk siste- byte) disponibile sulla prima 
ma ed utente. libreria aperta. 


Comandi con diversa sin Appartengono a questo gruppo i seguenti comandi: 
tassi nei due sistemi. 
CATALOG, DCHANGE,.-SAVE, CONFIGURE. 


La differenza saliente della nuova sintassi di tali 
comandi è che, operando in ambiente FDU, non sì speci 
ficano le librerie ma si fa riferimento al supporto 
(FDU1/FDU2). 

Se non viene specificato il supporto, si opera sulla 
libreria di sistema. 

Di seguito sono illustrati i nuovi formati. 


Comando CATALOG 





filename 


carfacos]| | [({fswe}KoJlA] 





FDUI 
neo [ance] di 
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Note 
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Comando SAVE 


LMR I I e 


SAV [E] filename LAGHI 





Comando CONFIGURE 





CON [F1euRe] [evo] L EP=n, |[.Ms=n, | 





1. Nel comando CATALOG, è possibile chiedere la sele- 
zione specifica soltanto per i file testo (T) oppu 
re oggetto (0). 


2. Nel comando CONFIGURE, è possibile chiedere la se- 
lezione specifica soltanto per il video esterno al 
fanumerico. 











Errori bloccandi durante 
l'assemblaggio 


ERRORE 


INSUFFICIENT SPACE ON 
DUI 
UNIT a FOR WORK 
FDU2 
FILE 


LOCATION COUNTER 
OVERFLOW 
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A. MESSAGGI DI ERRORE 


Questi messaggi identificano eventuali errori 


che 


si 


verificano durante la fase di assemblaggio (programma 
“di utilità ASM) oppure durante l'esecuzione di un modu 


lo Assembler (istruzione CALL). 
Gli errori di esecuzione di un modulo possono 


corretti durante la fase di esecuzione di un programma. 
Quando si verifica un errore; viene interrotta l'esecu 


e5 


sere 


zione del programma ed il sistema commuta nello stato 
di debugging se nella memoria sono presenti le routine 
di debugging (comando OPT DEB). Nello stato di debug - 
ging si può modificare opportunamente il codice ogget- 
to e riprendere l'esecuzione del programma (vedi capi- 
tolo 5). Se le routine di debugging non sono presenti 
in memoria l'unico modo per sbloccare il sistema dal- 


la situazione di errore è di premere il tasto 


il sistema ritorna nello stato comandi e quindi si pos 





sono effettuare le necessarie correzioni sul programma 
sorgente. Se una segnalazione di errore persiste 
diversi tentativi, ci si rivolga al più vicino servi - 


zio Olivetti evidenziando il messaggio visualizzato dal 


sistema, 


dopo 


Questo paragrafo descrive i messaggi di errore bloccan 


ti che si possono verificare durante l'esecuzione del- 


l'utility ASM; vengono segnalati dall'utility. 


DESCRIZIONE 


Gli extent liberi di disco ass segnati allo scratch file 
non sono sufficienti a contenere la stringa Intermedia 


e l'eventuale reference table: 


l'utente deve creare più spazio sul floppy disk indica 


to. 


Il location counter assegnato ad ognuna delle sezioni 


di controllo del programma sorgente supera 2 


el: 


ERRORE 


TOO MANY DEFINED NAMES 


TOO MANY DSECT 


TOO MANY EXTERNAL NAMES 


TOO MANY LITERALS 


Errori non bloccanti du 
rante l'assemblaggio 


ERRORE 
INSUFFICIENT SPACE ON 


UNIT a FOR OBJECT 
FDU2 


FILE 


DESCRIZIONE 


l'utente deve modificare in modo opportuno il proprio 
programma sorgente. 


L'utente ha definito nomi in eccesso rispetto al nu- 
mero consentito dalle dimensioni della memoria: 


l'utente deve o diminuire il numero dei nomi nel pro- 
prio programma sorgente o passare ad una macchina di 
capacità superiore. 


Il numero di dummy section definite supera 127: l’ u- 
tente deve modificare opportunamente il proprio pro» 


gramma sorgente. 


L'utente ha definito troppi nomi esterni, nel program 


ma sorgente, rispetto alla capacità assegnata al di- 


zionario: 


l'utente deve o diminuire il numero dei nomi esterni 
nel proprio programma sorgente o passare ad una mac- 
china di capacità superiore. 


L'utente ha definito literal tali che il codice ogget 
to generato, a fronte dei literal, supera la dimensio 
ne delta:tabetlasdei ‘literal; 


l'utente deve o diminuire il numero dei literal nel 
proprio programma sorgente o passare ad una macchi- 
na di capacità superiore. 


Questo paragrafo descrive i messaggi di errore non 
bloccanti che si possono verificare durante l'esecu - 
zione dell'utility ASM; vengono segnalati dall'utili- 
ty. 


DESCRIZIONE 


Sul supporto non ci sono extent sufficienti per allo» 
care il codice oggetto: 


l'utente deve creare più spazio sul floppy disk o fa- 
re scelte più opportune, a livello argomenti di lan - 
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ERRORE 





REP OVERFLOW 


OBJECT LENGTH 9 - FILE 
OBJECT NOT ALLOCATED 


SOURCE LITERAL TABLE 
OVERFLOW 





Segnalazioni diagnosti 
che durante. l'. assem — 
blaggio 
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DESCRIZIONE 


cio, nell'indicare l'unità di residenza del flusso di 
lavoro e del codice oggetto. 


Overflow nella cross reference. Tabella stampata in 
modo incompleto. 


Codice oggetto non allocato perchè, a fronte del pro- 
gramma sorgente, non è stato generato alcun codice Og 


getto. 


Tabella literal stampata in modo incompleto. 





Questo paragrafo descrive l'elenco delle segnalazioni 
diagnostiche emesse dall'Assemblatore, in fase di as 
semblaggio di un programma sorgente, a fronte di erro 
ri nel sorgente. L'apposizione del segno (*), in coda 
al testo dell'errore, indica che il messaggio è accom 
pagnato dall'indicazione della colonna, rispetto a i- 


[N 


nizio operandi, presso la quale si è rilevato l'erro-. 


re, L'indicazione della colonna, in certi casi, per 
ragioni inerenti alla logica del sistema, perde di si 
gnificato. 

Ogni segnalazione diagnostica è corredata di un codi- 
ce di due cifre (severity code) che indica la gravità 
dell'errore del sorgente: 


SEVERITY 


SVILUPPO 
CODE 

DA Errore ripristinabile che consente l'esecu 
zione di ogni eventuale passo successivo. 
L'oggetto generato dev'essere corretto pri 
ma della sua esecuzione. 

#8 Errore non ripristinabile sull'output gene 
rato. L'esecuzione di ogni passo successi 
vo dà risultati imprevedibili. 

12 Errore non ripristinabile. Non viene crea- 


to oggetto. 
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ERRORE 


AYG1 ILLEGAL NAME FIELD 


AQ92 INVALID NAME 


Ad93 INVALID OR MISSING 
OPERATION CODE 


DESCRIZIONE 
Spiegazione 


Nome assente in ftàsi in cui è obbligatorio indicare 
il nome frase DSECT e frase EQU, oppure nome pre- 
sente in frasi in cui il nome non è ammesso: frasi 
EXT/USING/DROP/END/ORG/frasi di controllo listing. 


sSeverity code 


48 
Sviluppo 


La frase in cui è rilevato questo errore è comunque 
analizzata e tradotta; la frase DSECT crea comunque 
una sezione fittizia; la frase EQU senza nome è pra- 
ticamente inoperante; i nomi non ammessi non sono 
posti nella tavola dei nomi. 


Spiegazione 


Il campo nome contiene un nome scorretto; contiene 
più di 8 crt, oppure non inizia con un carattere al- 
fabetico, oppure contiene dei caratteri speciali. 


Severity code 


98 


Sviluppo 


Il nome scorretto non viene posto nella tavola dei 
nomi; la frase in cui è rilevato questo errore è co- 
munque analizzata e tradotta. 


Spiegazione 


“x 


Nel campo operazione della frase non è stato indica- 
to un codice operativo, oppure il codice operativo 


non è correttamente isolabile, perchè costituito da 
più di 6 caratteri. 
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AY4 UNDEFINED OPERATION 


Ad95 ERROR IN LOGICAL 
SEQUENCE 
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Severity code 


12 
Sviluppo 


La “frase non viene presa in considerazione dall'Assem 
bler; l'eventuale nome presente non è posto nella ta- 
vola dei nomi. 


Spiegazione 


La stringa di caratteri indicata nel campo operazione 
della frase sorgente non corrisponde al codice mnemo- 
nico di una istruzione macchina, al codice di una i- 
struzione direttrice o di una macro-istruzione. 


peverity code 


12 
Sviluppo 


La frase non viene presa in considerazione dall'Assem 
bler; l'eventuale nome è posto nella tavola dei nomi, 


Spiegazione 


Frase fuori sequenza logica: frase PROC non segue im- 
mediatamente la frase START/CSECT di inizio Control 
Section; frasi, diverse dalle frasi commento, o comun 
que trattate come commento, diverse dalle frasi di con 
trollo listing e dalle frasi EQU, situate prima dello 
inizio della sezione di programma. 


Severity code 
12 


Sviluppo 


La frase fuori sequenza non è analizzata e tradotta 
dall'Assembler. 





Ad96 MISSING OPERAND 
FIELD 


A097 ILLEGAL CONTINUA- 
TION 


Spiegazione 


Campo operandi assente in frase in cui è obbligatorio. 


Severity code 


98 


Sviluppo 


Se si tratta di istruzione macchina, viene sviluppato 
l'oggetto a zero binario; l'eventuale nome viene po-— 
sto nella tavola dei nomi. Se si tratta di frase di- 
rettiva all'Assembier, essa non viene eseguita; in 
particolare nel caso di frasi di definizione dati con 
campo operandi assente non viene sviluppato alcun og + 
getto, e all'eventuale nome viene attribuita lunghezza 


- 1, 


Spiegazione 


Errore di continuazione: più di due linee di continua- 
zione; i primi 15 caratteri delle linee di continuazio 
ne non a }Y; il campo operandi sulle linee di continua- 
zione non inizia alla colonna 1 di continuazione del 
campo commento; l'ultima linea sorgente con l'indicati 
vo di continuazione. 


Severity code 


d8 
Sviluppo 


L'assembler isola il campo operandi fino a che è stato 
rilevato l'errore di continuazione. Si precisa che l'- 
assembler considera facenti parte di una stessa fra- 
se sorgente tutte le linee di continuazione indicate 
nel campo continuazione, anche oltre le due linee per 
messe in base alle specifiche del linguaggio: il campo 
operandi si considera comunque concluso nelle prime 
due linee di continuazione. 
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Nr 


AD08 ILLEGAL CHARACTER 
OR INVALID DELIMITER (*#) 


IEIERO ENER EROI ee 


AVI INCORRECT SPECIFI 
CATION OF REGISTER OR 
MASK (*) 
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Spiegazione 


Carattere illegale alla posizione indicata: l'Assem- 
bler si aspetta un termine, un operatore o uno dei 
due delimitatori che separano i sottocampi degli o 
perandi e gli operandi stessi (virgola, parentesi a 
perta o chiusa, apice di apertura della stringa ca- 
ratteri nelle pseudo di definizione dati) e non ilo 
trova. 


Severi ty code 
#8 
Sviluppo 


L'analisi e traduzione della frase si interrompe.Nel 
caso di istruzione macchina, l'oggetto viene genera- 


| to a # binario; nel caso di pseudo di definizione da 


ti viene generata la corrispondente stringa oggetto 
o a 9 binario o viene allocata la corrispondente a- 
rea solo se è stato possibile valutarne la lunghezza. 


Spiegazione 


L'espressione usata per indicare un registro o una 
maschera non ha valore assoluto, o comunque un valo- 
re assoluto compreso tra Y e 15, 


Severity code 

dB 

Sviluppo 

L'Assembler prosegue l'analisi sintattica e semanti- 


ca della frase; la stringa oggetto corrispondente è 
comunque posta a # binario. 


AG19 SYNTAX ERROR IN 
OPERAND FIELD (*) 










Spiegazione 


La sintassi della frase prevede la fine del campo ope 
randi e invece quest'ultimo continua scorrettamente. 


Severity code 


d8 
Sviluppo 


L'Assembler interrompe l'analisi della frase, la cui 


corrispondente eventuale stringa oggetto è posta a $@ 
binario. 














AG11 INCORRECT SPECIFI- 
CATION OF IMMEDIATE (*) 


Spiegazione 


L'espressione usata per indicare un valore immediato 
non è assoluta, o non ha valore compreso tra Y e 255, 
oppure tra 1 e 16, 


Severity code 
d8 


Sviluppo 


L'Assembler prosegue l'analisi sintattica e semanti 


ca della frase; la stringa oggetto corrispondente è 
comunque posta a # binario. 






AY12 PREMATURE END OF 
THE OPERAND FIELD 


Spiegazione 





Fine prematura del campo operandi: sulla frase sorgen 
te non è stato indicato il numero di operandi previ- 


> 


sto, oppure la specificazione di un operando è incom- 
pleta. 


Severity code 


08 


A-8 | 3978380 T 


A#13 ALIGNMENT ERROR 


AGI4 TOO MANY OPERANDS 
(*) 
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Sviluppo 


L'analisi della frase termina; l'oggetto relativo è 
posto a # binario; nel caso di pseudo definizione da 
ti viene generata la corrispondente stringa oggetto 
a 9 binario o viene allocata la corrispondente area 
solo se è stato possibile valutarne la lunghezza. 


Spiegazione 


Errore di allineamento: la frase richiede che l'ope- 
rando sia allineato alla parola o alla semi-parola: 
questo errore viene segnalato solo quando l'indiriz- 
zo è espresso in modo implicito e tale indirizzo è 
dispari; in particolare viene segnalato nel caso in 
cui l'operando è espresso tramite literal il cui in- 
dirizzo risulti appunto dispari. 


Severity code 


DA 
Sviluppo 


L'Assembler continua l'analisi e la ‘traduzione del 
la frase, 


Spiegazione 


Nella frase sorgente è stato specificato un numero 
di operandi eccessivo: 


»- più di 16 registri specificati in una frase USING 
o DROP 


più di 31 parametri specificati in una frase CALL 
o CALEXT o CALEXS 


» più di 31 nomi esterni indicati in una frase EXT 


» troppi operandi specificati in una qualsiasi i -— 
struzione-macchina; questo è il caso ad esempio 
in cui la posizione di inizio del literal even -— 
tualmente indicato non coincida con la posizione 








AY15 INVALID LENGTH IN 
MACHINE INSTRUCTION (*) 


AQ16 INVALID DISPLACE- 
MENT SPECIFICATION (*) 
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di fine dell'operando precedente. 


Severity code 
d8 


Sviluppo 


Si interrompe l'analisi e la traduzione della frase: 
la stringa oggetto è generata a zeri binari. 


Spiegazione 


La lunghezza implicita o esplicita indicata in una i- 
struzione-macchina non ha valore compreso fra 1 e 256 


| oppure tra 1 e 16, La lunghezza esplicita è stata e- 


spressa tramite una espressione non assoluta. 


Severity code 
98 


Sviluppo 


L'analisi della frase sorgente prosegue; la stringa 
oggetto viene comunque generata a zeri binari. 


Spiegazione 
In una istruzione-macchina il:campo scostamento è sta 
to indicato tramite una espressione non assoluta, lo) 


comunque tramite una espressione il cui valore non è 
compreso tra d e 4995, 


Severity code 
d8 
Sviluppo 


L'analisi della frase sorgente prosegue; la stringa 
oggetto è comunque generata a zeri binari. 
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AQ17 REGISTER NOT PRE- 
VIOUSLY USED (*) 


AY18 ADDRESSABILITY ER 
ROR (*) 


AG20 TOO MANY TERMS IN 
EXPRESSION (*) 
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Spiegazione 


Un registro specificato in una frase DROP non è stato 
precedentemente definito come registro base in una op 
portuna frase USING. 


Severity code 
dA 
Sviluppo 


L'Assembler ignora il registro specificato e prosegue 
nell'analisi della frase DROP. 


Spiegazione - 


L'Assembler non riesce a risolvere l'indirizzo impli- 
cito specificato nella frase sorgente, poichè nessun 
registro base definito con una precedente frase USING 
è disponibile, cioè nessun registro base ha lo stesso 
attributo di rilocabilità dell'espressione che espri- 
me l'indirizzo implicito o comunque quest'ultima ha 
un valore tale da dar luogo a uno scostamento 4995, 


Severity code 


#8 
Sviluppo 


L'analisi della frase sorgente prosegue; la stringa 


LS 


oggetto è generata a zeri binari. 


Spiegazione 


Espressione con più di 16 termini. 


Severity code 


d8 
Sviluppo 


L'analisi della frase termina. 


A-1l1 





AY21 MORE THAN 5 LEVELS 
OF PARENTHESES (*) 





AY22 RIGHT PARENTHESES 
OMITTED 


A#23 UNDEFINED OR NOT 
PREVIOUSLY DEFINED SYM 
BOL (*) 
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Spiegazione 

Espressione con più di 5 livelli di parentesi. 
Severity code 

de. 


Sviluppo 


L'analisi della frase termina. 





Spiegazione 

Parentesi di chiusura omesse in una espressione. 
Severity code 

08 

Sviluppo 


L'analisi della frase sorgente sì interrompe. 


Spiegazione 


Nella frase sorgente è indicato un simbolo non defini 
to oppure un simbolo non precedentemente definito quan 
do la previa definizione è richiesta (ad esempio fra- 
si EQU, ORG .....). 


Severity code 


d8 


Sviluppo 


L'espressione non può essere valorizzata; l' analisi 


. della frase prosegue sugli operandi successivi. 
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‘ AG24 INVALID SELF-DEFI- 
NING TERM (*) 


AY25 SYNTAX ERROR IN 
SELF-DEFINING TERM (*) 


Ad26 VALUE OF SELF-DEFI . 


NING TERM TOO LARGE (*) 
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Spiegazione 


Termine autodefinito scorretto: i caratteri indicati 
nella stringa non sono conformi al tipo del termine 
stesso. 


Severity code 
98 


Sviluppo 


L'espressione non può essere valorizzata; l'analisi 
della frase comunque prosegue, 





Spiegazione 


Termine autodefinito non isolabile perchè non trova 
l'apice di chiusura della stringa in posizione cor- 
retta. 


Severity code 


98 
Sviluppo 


Si interrompe l'analisi sintattica della frase sor -— 
gente. 


Spiegazione 


Termine autodefinito decimale con valore superiore a 
16.777.215. 


Severity code 


d8 
Sviluppo 


L'espressione non può essere valorizzata; l'analisi 
della frase comunque prosegue. 


A-13 


AG27 PREMATURE END OF Spiegazione 

EXPRESSION (*) 
Espressione troncata; ad esempio espressione che ter- 
mina con un operatore aritmetico. 


Severity code 
d8 
Sviluppo 


L'analisi della frase è interrotta. 


AG28 ARITHMETIC OVERFLOW Spiegazione 

IN EXPRESSION EVALUATION 

(*) i Overflow nel calcolo dell'espressione: ibi risultato 
intermedio non è compreso fra 2 = Tue 2 


Severity code 


98 


Sviluppo 


L'analisi della frase prosegue. 


AY29. FINAL RESULT OF EX Spiegazione 
PRESSION OUT OF RANGE 
(*) Risultato dell'espressione negativo o comunque supe - 


riore a 2 »-l. 


‘ Severity code 


d8 
Sviluppo 


L'analisi sintattica e semantica della frase sorgente 
prosegue. 
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AG3Y RELOCATABILITY ER- Spiegazione 

ROR (*) 
Non è possibile valutare l'attributo di rilocabilità 
dell'espressione perchè più di un termine rilocabile 
risulta spaiato oppure il termine spaiato è precedu= 
to dall'operatore. +— , 


Severi ty code 
98 


Sviluppo 


L'espressione non è valorizzata; l'analisi della fra 
se prosegue. 


AY31 FIRST OPERAND OF | Spiegazione 

DIV./MULT. IS RELOCATA 

BLE (*) Espressione in cui compare un termine rilocabile co- 
me primo operando di una divisione o di una moltipli 
cazione. 


Severi ty code 
d8 


Sviluppo 


L'espressione non è valorizzata; l'analisi della fra 
se prosegue, 


AY32 SECOND OPERAND OF ° Spiegazione 

DIV./MULT. IS RELOCATA 

BLE (*) Espressione in cui il secondo operando di una divi + 
sione o moltiplicazione è rilocabile. 


Severity code 
da 
Sviluppo 


L'espressione non è valorizzata; comunque l'analisi 
della frase prosegue. 
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A#33 BOTH THE OPERANDS OF Spiegazione 

DIV./MULT. ARE RELOCATA- i 

BLE (*) Espressione in cui compare una divisione o moltiplica 
zione fra termini rilocabili. 


Severity code 


98 
Sviluppo 


Non è possibile calcolare il valore dell'espressione; 
l'analisi della frase prosegue. 


Ad34 EXPRESSION START Spiegazione 
| WITH OPERATOR (*) °° | 

; Il primo termine dell'espressione è preceduto dall'o- 
peratore aritmetico. 


Severity code 


48 
Sviluppo 


L'analisi dell'espressione e della frase termina. 


AY35 DIVISION BY. ZERO IN Spiegazione 

EXPRESSION (*) i 
Nell'espressione compare una divisione con valore da 
divisore. 


Severity code 
dA 
Sviluppo 


‘ Il risultato della divisione di un termine per un al- 
tro termine con valore 4 è posto a &. 
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A936 UNKNOWN TYPE (*) 








Ad37 DUPLICATION FACTOR 
ERROR (*) 








Spiegazione 


Scorretta indicazione del tipo di una frase DC/DS o 
in un literal. 


Severity code 


12 
_Sviluppo 


L'analisi della frase viene interrotta; non viene ge 
nerata alcuna stringa oggetto. 





Spiegazione 


Scorretta indicazione del fattore di duplicazione di 
una frase DC/DS o in un literal: il fattore di dupli 
cazione è stato indicato con una espressione non ast 
soluta, o comunque ha valore superiore a 65,535; in 
un literal è stato indicato un fattore di duplicazio 
ne uguale a zero. 


Severi ty code 


12 
Sviluppo 


Prosegue l'analisi della frase: non viene generata 
alcuna stringa oggetto, 








Ad38 DUPLICATION FACTOR 
NOT ALLOWED (*) 
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Spiegazione 


Errata indicazione del fattore di duplicazione in 
frasi DC o DS o in literal di tipo indirizzo. 


Severity code 


12 
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AG39 S-TYPE CONSTANT IN 
LITERAL (*) 


AZ40 INVALID LENGTH MO- 
DIFIER (*) 


AG41 PREVIOUSLY DEFINED 
NAME 
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Sviluppo 


L'analisi della frase termina; non viene generata al- 
cuna stringa oggetto. 


Spiegazione 


‘ Costante indirizzo di tipo S indicata in un literal. 


Severity code 


12 


Sviluppo 


| L'analisi della definizione del literal si interrompe; 


non viene generata alcuna stringa oggetto. 


Spiegazione 


Errata indicazione del modificatore di lunghezza in 
una frase DC o DS o in un literal: il modificatore di 
lunghezza è stato espresso con una espressione non as 
soluta, o comunque ha valore fuori range rispetto al 


tipo di costante. 


Severity code 


12 


; Sviluppo 


L'analisi della frase prosegue; non viene generata al 
cuna stringa oggetto. 


Spiegazione 


Nella frase è definito un nome già definito in una 
precedente frase sorgente. 
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Severity code 


d8 
Sviluppo 


Rimane valida la prima definizione del nome. 


AY42 INVALID OPERAND IN Spiegazione 

ORG STATEMENT ° 
Nella frase ORG l'operando è espresso tramite una e 
spressione non rilocabile, o una espressione il cui 
attributo di rilocabilità è diverso rispetto alla 


sezione in cui compare la frase stessa. 


Severity code 


98 
Sviluppo 


Il location counter rimane immutato; la frase è quin- 
di inoperante. 


AG43 CONSTANT TRUNCATED- Spiegazione 

HIGH ORDER DIGITS LOST 
I bit di ordine superiore di una costante o literal 
di tipo H/F sono persi poichè il campo definito è trop 
po piccolo per contenere l'intero valore delle costan 
ti. 


Severity code 
d4 
Sviluppo 


Viene generata una stringa oggetto per la lunghezza 
implicita o esplicita indicata con il valore troncato. 
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AYA44 INVALID CONSTANT(*) 





AYA45 QUOTES NOT PAIRED 
IN DC/DS/LITERAL (*) 


AYA46 INCORRECT OR DUPLI 
CATE KEYWORD OPERAND (*) 
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Spiegazione 


Errata indicazione del valore della costante in frasi 
DC e DS o in literal: i caratteri indicati non sono 
compatibili con il tipo di costante. 


Severity code 


d8 


Sviluppo 


La stringa oggetto viene generata a zeri binari se la 
lunghezza della costante è indicata esplicitamente :al 
trimenti nessuna stringa viene generata. 


Spiegazione 
L'indicazione del valore costante in frasi di defini- 


zione dati o in un literal non ha l'apice di chiusura; 
apici non pari nelle costanti tipo C. 


Severity code 


98 
Sviluppo 


La stringa oggetto viene generata a zeri binari se la 


lunghezza della costante è indicata esplicitamente 


altrimenti nessuna stringa è generata. 


Spiegazione 
Operando a parola-chiave compare più di una volta nel 


l'ambito di una macro-istruzione oppure parola-chiave 
scorretta alla posizicne indicata. 


Severity code 


12 
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Sviluppo 


L'Assembler prosegue nell'analisi sintattica della ma 
cro-istruzione; non viene però generata alcuna espan- 
sione. 





AY47 INVALID OPERAND IN Spiegazione 

MACRO-INSTRUCTION (*) 
Operando invalido in una macro-istruzione perchè non 
è riconosciuto nè come simbolo nè come termine autode 
finito decimale. 


Severity code 


12 


Sviluppo 


L'Assembler prosegue l'analisi sintattica della frase; 
non viene generata alcuna espansione. 


AG48 INVALID USING STA- Spiegazione 

TEMENT 
Nella frase USING è stato indicato come registro base 
il registro generale gi non in prima posizione. 


Severity code 


d8 
Sviluppo 


L'analisi e l'esecuzione della frase si interrompe. 
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Errori durante l'esecu- 
zione del modulo Assem- 


bler 


CODICE DI ERRORE 


ABEND 


ABEND 


ABEND 


ABEND 


ABEND 


ABEND 


ABEND 


ABEND 


ABEND 


ABEND 


- A=22 


ll 
12 
13 


14 


Questo paragrafo descrive le condizioni di Abort di 


programma che si possono verificare durante l'esecu - 
zione di un modulo Assembler lanciata da una CALI. 


DESCRIZIONE 

Overflow di stack. 

Execute di una execute. 
Indirizzamento fuori memoria. 


Formato istruzione errato degli operandi. 
Istruzione RLSEM di segmento non attivo. 


Errore imputabile a hardware. 

Underflow di stack. 

Opzione inesistente. 

T1 floppy disk di sistema è danneggiato. 
Errore di allineamento. 


Codice operativo inesistente. 


Il formato di questi messaggi di errore 
te: 


ABEND XX IN module-name 


dove: 


è il seguen 


module-name indica il nome del modulo Assembler. 
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B., FORMATO DEI DATI IN. MEMORIA 


I dati trattati dalla macchina si suddividono in due 
gruppi: 


- dati numerici; 
- dati alfanumerici (stringa). 


Formato numerico I dati numerici sono espressi in virgola mobile {(floa 
ting point), a singola o doppia precisicne, da un nu- 
mero della forma: 





E 
N*10 
dove: 
+ È 
[C] X. YYYYY in S.P. 
N È) 
+ 
| K.YYYYYYYYYYYY in D.P, 
b 
con 1 X 9 e 9 Y 9; 
intero compreso tra -63 e +63 in S.P. 
E = 
intero compreso tra -99 e +99 in D.P. 
Esempi: 


: 2 
123(SP) = 1,23000*10 
1 
-30,4795(DP)= -3.047950000000*10 
5 
0,00009437(SP)= 9,43700*10 


Il formato dei dati numerici in memoria dipende dalla 
precisione dei dati stessi. 
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Singola precisione 














bit & 4 & & 64 1 
PPEEPI]e 
4 byte 
dove: 
DI 2 DE = cifre del dato numerico (4 = 9); 
S = segno (+ = 1; - = d); 
EXP = valore dell'esponente (espresso in esade- 
cimale): 
decimale esadecimale 





Doppia precisione 





bit 





8 byte 
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dove: 


SIGN = segno in esadecimale (+ = B; - = D); 
DI > D13 = cifre del dato numerico (9 + 9); 
EXP = valore dell'esponente (espresso in esa- 


decimale): 


decimale esadecimale 





Note 1) Se il dato numerico non è definito,il valore dello 
esponente è 4. 


2) Se il dato numerico è una costante = d, il forma 


to relativo -è il seguente: 


Singola precisione Doppia precisione 


(+) 
dI (-63). 
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Formato stringa Il formato dei dati alfanumerici in memoria è il se- 


guente: 





bit 











dove 

Cc si Pe 

S = definitezza (9_ = stringa non assegnata; 1 = 
stringa assegnata); 

LEN = lunghezza attuale della stringa in byte (ov- 
vero, numero di caratteri validi); 

DI - DN = elementi della stringa (ovvero codici ISO 


dei caratteri) ognuno di 1 byte. 


Esempi 





3 


"= 10 


COERREICEN 





‘= 0,00431 SP 
byte 





‘9.52834 10° 


928,34 DP PERENNE 
__——__n ccm II tti 


8 byte 





FMI 





cost=0 DP 
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4.78596 


V478596 SP IROGONEE 
Pra si 


+ 10° 


nl 1000101 


Stringa assegnata: NR.1 


LEN=4 


[11|1poo00001 00 01001110|01010010/00101110/00110001 
Tag TE I ERI 


2 byte 4 byte 
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È 
{ 











C. ACCESSO DIRETTO AI DATI IN MEMORIA DA MODULO AS- 


SEMBLER 
Dati accessibili al il modulo Assembler può accedere direttamente ai da- 
modulo Assembler ti contenuti nella memoria di sistema. 


Le classi di dati cui il modulo può accedere sono le 


seguenti: 


- variabili numeriche semplici; 
- variabili numeriche multiple; 
- variabili stringa semplici; 

. = variabili stringa multiple. 


I nomi e le caratteristiche (ovvero, i descrittori)di 
ciascun elemento di ogni classe di dati sono organiz- 
zati nelle seguenti tabelle di memoria: 


NOME DELLA TABELLA CONTENUTO DELLA TABELLA 
Numeric Variable Symbol Table (NVST) Nomi delle var. num. semplici 
Numeric Array Symbol Table (NAST) Nomi delle var. num. mult. ed indiriz 


zi del.1° elem. di ogni var. 


String Variable Symbol (SVST) Nomi delle var. stringa semplici e in 
dirizzi assoluti di ogni var. 


String Array Symbol Table (SAST) Nomi delle var. stringa mult. ed indi 
° rizzi del 1° elem. di ogni var. 


3978380 T C-1 


Gli indirizzi d'inizio di queste tabelle sono contenu 
ti parte in ZRM e parte in COMAREA: 


ZONA DI MEMORIA 
COMAREA 











INDIRIZZO 


A = Address 
(indirizzo) 


“SASTA 


Per accedere a tali indirizzi è quindi necessario che 
le relative zone di memoria (ZRM, COMAREA) siano deri 
nite all'assemblatore, Tale esigenza è soddisfatta con 
le istruzioni: 


COPY ZRM 
COPY COMARE. 


Durante la ricerca di un elemento di una tabella, non 
si deve sconfinare dalla tabella stessa. Per rispetta 
re questa esigenza, è necessario conoscere il numero 
di elementi che compongono ogni tabella. 
Questi numeri sono contenuti in COMAREA: 







NUMERO DI ELEMENTI 






NVSTUI UI = Used Items (elementi u- 
NASTUI tilizzati) 
SVSTUI 


SASTUI 


La tabella dei descrittori delle variabili numeriche 
semplici, a differenza delle altre tabelle, ‘fornisce 
soltanto il nome delle variabili, non ne fornisce lo 
indirizzo di allocazione. 


I valori delle variabili numeriche semplici sono orga 
‘nizzati in memoria a partire da un indirizzo contenu- 
to nel campo NVA (Numeric Variable Address) della ZRM. 
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Variabili numeriche sem: 


plici (A..006.Zs 
+.79) 
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AG... 


Ogni valore occupa 8 byte, indipendentemente dal tipo 
di precisione (singola o doppia): 





19 valore 29 valore 





- 


Se il valore è in singola precisione, è rappresentato 
(vedi Appendice B) sui primi 4 byte; i rimanenti 4 by 
te non sono significativi: 





4 byte & byte 





VALORE 


8 byte 





“ 


La tabella NVST è formata da tanti campi di 2_ byte 
ciascuno, quante sono le variabili numeriche semplici 
(cioè NVSTUI). Ogni campo è organizzato come segue: 
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dove: 


NAME = nome della variabile (lettera =I 5 bit meno si 
gn. del corrispondente codice ISO; cifra =: _4 
bit meno sign. del corrispondente codice ISO); 


Esempi: 
NAME 
lettera F = 0 1 0/0 0110 
- lettera X = 0 1 0/10111 
lettera N = 0 1 0]O01111 
À . 


Parte di codice comune 
a tutte le lettere ISO 


NAME 
Possenti 


cifra 1=20011/0001 

cifra O 01 10100 

cifra 9=001 11001 
tt 


pas 
il 


Parte di codice comune 
a tutte le cifre ISO. 


T = precisione (singola = d; doppia = 1); 
RIF = contatore dei riferimenti (quante volte la va- 


riabile viene riferita nel programma). 


La ricerca di una variabile numerica semplice di nome 
noto si articola nelle seguenti fasi: 


1) In NVSTA è contenuto l'indirizzo del nome della 

prima variabile semplice; i nomi - delle variabi-. 
li successive si ottengono incrementando ogni vol- 
ta di 2 l'indirizzo precedente; 


peg perl Pel 


(NVSTA) +2 +2 +2 





ra 3 
fo] 


2) Trovata la variabile desiderata, se ne ottiene di 
conseguenza il numero d'ordine K nell'ambito della 
relativa tabella (NVST); si noti che le variabili 
sono numerate a partire da @; 
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3) L'indirizzo di allocazione del valore della varia- 
bile si ottiene sommando il seguente scostamento d 
all'indirizzo contenuto in NVA: 


Esempio 
Data lia seguente situazione schematica di memoria: 









DP 


NVST 
NV 
| -2 
a x - 5.0 10 
I [D | SANANAAAANNAN 
(NVA=8304 ' 


8 byte 





reperire il valore della variabile B: 


- numero d'ordine di B (K = 6): si ricava attraverso 


opportune istruzioni di ricerca in tabella (vedi 


P6066 Linguaggio Assembler + GR code 3978440 Z); 
- scostamento: d = 6 * 8; 
- indirizzo di allocazione del valore di B: 


I = (NVA)+4, 


Nota: Per il formato dei valori delle variabili, si veda la 
Appendice B. 


Variabili numeriche mul La tabella NAST è formata da tanti campi di 10 byte 
tiple (A......Z) . ciascuno, quante sono le variabili numeriche multipie 


(cioè NASTUI). 
Ogni campo è organizzato nel modo seguente: 
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dove: 


NAME = nome della variabile (i 5 bit meno sign. del 
corrispondente codice ISO); 


T = precisione (singola = J; doppia = 1); 

D = dimensioni (1 dimensione = 4; 2 dimensioni = 
LI 

fio: = se la variabile è comune è C=1; altrimenti è 
C=9; 

RIF = contatore dei riferimenti; 

Al = numero di elementi meno uno della variabile 


DIM1 = numero di righe meno una della variabile (se 
è a 2 dimensioni ) oppure zero (se è ad 1 di- 
mensione); 


DIM2 = numero di colonne meno una della variabile (se. 


x 


è a 2 dimensioni) oppure numero di elementi 


DS 


della variabile (se è ad 1 dimensione); 


ADD = indirizzo assoluto di parola del primo elemen 
to della variabile. 


La ricerca dell'elemento (i, j) di una variabile nume 
rica multipla di nome noto si articola nelie seguenti 
fasi: 


1) In NASTA è contenuto l'indirizzo del nome della pri 
ma variabile numerica multipla; i nomi delle varia 
bili successive si ottengono incrementando ogni vol 
ta di 10 l'indirizzo precedente: 








| | | 


(NASTA) +70 +10 
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2) Trovata la variabile desiderata, se ne preleva lo 
indirizzo assoluto di parola ADD, incremertando di 
8 l'indirizzo del nome della variabile; 


3) L'indirizzo di ‘allocazione del primo elemento della 
variabile si ricava moltiplicando per 4 l'indirizzo 


ADD; 

4) L'indirizzo di allocazione dell'elemento (i,.j) desi 
derato si ricava sommando all'indirizzo del primo 
elemento il seguente scostamento d: 

{4 in S.P. 

d =(j=-1)}*(DIMI+1)+i-1]* 

l [i )*( La Le 

dove: 

i = indice di riga; 

DIM1+1 = numero di righe (= 1 nel caso di variabi- 
le ad 1 dimensione); 

j = indice di colonna (= indice degli elemen- 
ti nel caso di variabile ad 1 dimensione). 

Esempio. 


Data la. seguente situazione schematica di memoria: 













Ss DP 20 A1=80 DIM1=8 DIM2=8 ADD 
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reperire l'elemento (12) della variabile ad una dimen 
sione B (di 306 elementi) e l'elemento (4, 3) della 
variabile a due dimensioni S (di 9 x 9 elementi). 
Variabile B: 


- indirizzo del descrittore di B: si ricava attraver 
so ricerca per incrementi successivi di 10 dell'in 
dirizzo contenuto in NASTA; nel caso specifico è: 


I, = (NASTA)+10; 


- prelievo indirizzo di parola dei primo elemento di 
B: 


DD) = I 8; 
{ADD) ci: 


- indirizzo di allocazione del 1° elemento di B: 
I = (ADD)*4; 
Bi i 


- indirizzo di allocazione dell'elemento (12) di B: 


Ss da j-1)*(DIM1+1)+i-1|[*4 = 
Io O, L,,*[(s )*(DIM1+1)+i 1] 4 


= Pa * sE % = 
1,,+[(12 1)*(0+1)+1 1] 4 I 1144 


Variabile S: 
- indirizzo del descrittore di S: si ricava attraver 
so ricerca per incrementi successivi di 10 dell'in 


dirizzo contenuto in NASTA; nel caso specifico è: 


Is = (NASTA)+10+10+10+10+10 = (NASTA)+50; 


.- prelievo indirizzo di parola del primo elemento di 


Ss: 
(ADD) = 1,48; 
- indirizzo di allocazione del 1° elemento di S: 


I = (ADD)*4 
s1,1 (ROD) 


- indirizzo di allocazione dell'elemento (4,3) di S: 


Ò d=1 j= = pa -} = 
154,3 to1,1* s[ 1)*(DIM1+ )+1-1|*8 


[(-1) e (espe =. I +168, 


2 
sui” s1,1 
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Variabili stringa sempli 
ci (A$...Z$, AD$...Z9$) 
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La tabella SVET è formata da tanti campi di 7 byte 
ciascuno, quante sono le variabili stringa semplici 
(cioè SVSTUI). 

Ogni campo è organizzato come segue: 


dove: 


NAME 


RIF 


(7, 


LEN 


ADD 





nome della variabile (lettera = i 5 bit meno 
sign. del corrispondente codice ISO; cifra = 
i 4 bit meno sign. del corrispondente codice I 
SO); 


se la variabile è comune è C=1, altrimenti è 
C=d; 


= contatore dei riferimenti; 


119909 


lunghezza di allocazione della variabile (1 


1023), definita da DIM; 


ole 


indirizzo assoluto della variabile. 
sit i 440 assoluto 


La ricerca di una variabile stringa semplice di nome 


. noto si articola nelle seguenti fasi: 


1) In SVSTA è contenuto l'indirizzo del nome della 


prima variabile stringa semplice; i nomi delle va 


riabili successive si ottengono incrementando ogni 


volta di 7 l'indirizzo precedente: 








2) Trovata la variabile desiderata, se ne preleva l'in 
dirizzo assoluto 'ADD incrementando di 4 l'indirizzo 
del nome della variabile; 


3) L'indirizzo di ‘allocazione della variabile si rica- 
va incrementando di 2 l'indirizzo assoluto ADD. 


Esempio. 
Data la seguente situazione schematica di memoria: 








(SVSTA)=8959 





reperire il contenuto della variabile M1l$: 

- indirizzo del descrittore di M1$: si ricava attra- 
verso ricerca per incrementi successivi di 8 dello 
indirizzo contenuto in SVSTA; nel caso specifico è: 
I = (SVSTA)+7+7+7 = (SVSTA)+21; 

- prelievo dell'indirizzo assoluto di M1$: 
(ADD) = 144; 


- indirizzo di allocazione del valore di M1$: 


Lig = (ADD) +2. 


Variabili stringa multi | La tabella SAST è formata da tanti campi di 13 byte 
ple (A$....Z$) ciascuno, quante sono le variabili stringa multiple 
(cioè SASTUI). 
Ogni campo è organizzato come segue: 
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dove: 


NAME 


RIF 


Al 


DIMI 


DIM2 


LEN 


ADD 


13 byte 


nome della variabile (i 5 bit meno sign. del 
corrispondente codice ISO); 


dimensioni (1 dimensione = d; 2 dimensioni = 
—_ IMI ONE s Xi < dimensioni = 
do 


se la variabile è comune è =1, altrimenti è 
C=d; 


contatore dei riferimenti; 


numero di elementi meno uno della variabile; 
Men LI Meno uno 


numero di righe meno una della variabile (se 


- 


è a 2 dimensioni) oppure zero (se è ad una di 
E SAVCNSIONI Pal BASO RO 

mensione); 

SIP EOLO 


numero di colonne meno una della variabile (se 
ia OT OnNne meno una 
€ a 2 dimensioni) oppure numero di elementi 
So ISIIGITONI n i STOMENTI 
della variabile (se è ad una dimensione); 
EMO LOLO: 


lunghezza di allocazione dell'elemento (defi- 


nita da DCL); 


indirizzo assoluto del primo elemento della 
tt Coi LO del primo elemento; 


variabile, 


La ricerca dell'elemento (i,j) di una variabile strin 
ga multipla di nome noto si articola nelle seguenti 


‘ fasi: 


C+11 





1) In SASTA è contenuto l'indirizzo del nome della pri 


ma variabile stringa multipla; i nomi delle variabi 
li successive si ottengono incrementando ogni volta 
di 13 l'indirizzo precedente: 





(SASTA) +15 +13 





2) Trovata la variabile desiderata, si preleva l'indi- 
rizzo assoluto ADD del suo primo elemento, incremen 
tando di 10 l'indirizzo del nome della variabile; 


3) L'indirizzo di allocazione dell'elemento (i,j) desi 
derato si ricava sommando all'indirizzo del primo 
elemento il seguente scostamento d: 

d = [5-19 + (010241) viper) 
dove: 
i = indice di riga; 


DIM1+1 = numero di righe (= 1 nel caso di variabile 
aa 1 dimensione); 


j = indice di colonna - (= indice degli elemen- 
ti nel caso di variabile ad 1 dimensione); 


LEN = lunghezza di allocazione dell'elemento {de 
finita da DCL).: 
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Esempio. 
Data la seguente situazione schematica di memoria: 


A 20 AI = 8 DIMI = 2 DIM2 = 2 


000071]. [0000900000001 000]000000NN00000010[000000000000001 9] | — 
I 


SAST 





(SASTA)= 8140 





reperire l'elemento (2, 3) della variabile A$ (di 3x3 


elementi di 4 byte ciascuno): 


‘—- indirizzo del descrittore di A$: si ricava attra- 
verso ricerca per incrementi successivi di 13 del- 
l'indirizzo contenuto in SASTA; nel caso specifico 


x 


è: 
I = (SASTA)+ 13 + 13 = (SASTA)+ 26; 


- prelievo dell'indirizzo assoluto del 1° elemento 
di AS: 


(ADD) = I + 10; 


- indirizzo di allocazione dell'elemento (2, 3) di 


AS: 


Lig 


(ADD) +[(j-1)*(DIM1+1)+i-1]* (2+LEN) = 
z (ADD) + [(3-1)*(2+1)+2-1]* (244) = 


(ADD)+ 42 


(l 
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D. COME RENDERE RESIDENTE UN MODULO ASSEMBLER 
SI IVUVILI ADOEMBLER 


Ogni modulo Assembler chiamato da una istruzione CALL 
viene attivato all'atto della chiamata e viene disat- 
tivato al termine del modulo, quando il controllo ri- 


torna al programma. 


Ogni modulo Assembler inizia con una testata di 14 by 
te; il secondo byte della testata (ACTCOUNT) è utiliz 
zato per indicare se il modulo è attivo (#4 4) o disat 
tivo (= d): 





1° byte 2° byte 39 byte 4° byte 14° byte 





- l'attivazione del modulo è frutto dell! incremento 
dell'ACTCOUNT di una unità; 


- la disattivazione del modulo è frutto del decremen- 
to dell'ACTCOUNT di una unità. 


Per rendere residente in memoria un modulo Assembler 
è pertanto sufficiente incrementare ulteriormente di 
‘1 il contenuto dell'ACTCOUNT, mentre per rilasciare 
un modulo residente è sufficiente decrementare ulte- 
riormente di 1 il contenuto dell'ACTCOUNT. 

Per accedere all'ACTCOUNT è necessario conoscere l'in 
dirizzo di inizio modulo, caricato nel registro base, 
Il registro base viene caricato dopo il prologo attra 
verso l'istruzione BALR, , 
Consideriamo pertanto l'inizio di un modulo Assembler 
e la relativa occupazione di memoria (in byte): 
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Note 


N° SEG. I 
ACTCOUNT ‘ 2 
TESTATA |! i 
: 14 
START 
PROLOGO 
PROC 15 * 26. (12 byte) 
BALR 27 = 28. ( 2 byte) 





Quando viene caricato il registro base, lo scostamento 


ri 


spetto all'inizio del modulo è di 28 byte; per indi- 


- 


viduare 1' ACTCOUNT è pertanto sufficiente sottrarre 27 
al contenuto del registro base, 


1) Il contenuto del registro base deve rimanere costan 


3) 


te per tutta l'esecuzione del modulo in quanto tut- 
ti gli indirizzi sono calcolati rispetto a tale re- 
gistro,. 

Per eseguire la sottrazione, si consiglia pertanto 
di utilizzare un altro registro. 


La disattivazione di un modulo residente è indi + 
spensabile quando si desidera utilizzare una routi- 
ne diversa: poichè l'area di overlay può contenere 
una sola routine attiva alla volta, se il modulo re 
sidente non venisse disattivato, ogni chiamata a mo 
duio diverso avrebbe come risultato l' esecuzione 
deì modulo residente. 


Nel caso non si desideri l'allocazione dell'area lo 
cale (vedi paragrafo Prologo, capitolo 2), quando 
viene caricato il registro base lo scostamento è di 
16 byte anzichè 28; per individuare l'ACTCOUNT, si 
deve. in tale caso sottrarre 15 anzichè 27: 
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TESTATA 


-PROLOGO { 


byte 
N° SEG. 1 
ACTCOUNT. 2 
s 14 
START 
PROC PROLOG = NO 
BALR 15 + 


. 


16 


(2 byte) 
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E. ESEMPIO APPLICATIVO DI PROGRAMMA BASIC COMPLETO DI 
inizi Dolo VUMPLE TU 2I 
MODULO ASSEMELER 


Il seguente programma consente di trattare una stringa 
non superiore a 256 crt in uno dei seguenti modi: 


FUNZIONE 9 


+ FUNZIONE 1 


+ FUNZIONE 2 


. FUNZIONE 3 


+ FUNZIONE 4 


Il programma 


Trasformare tutti i crt aella stringa 
in ert NUL, 


Sondare se un bit selezionato della 
stringa è uguale a 1. 


Settare un bit selezionato della strin- 
ga. 


Resettare un bit selezionato della strin 
ga. 


Cancellare (DELETE) tutti i crt della 
stringa. 


impiega un modulo Assembler di nome 


"ASMOBJ" per elaborare le funzioni suddette, 
I listing che corredano questo esempio sono autocommen 


tati. 


L'Propramma BASIC 





1G19 DEL Z56(HM£,8£)] 

Gai 29 DUL 25C(C£3 

aa3:a LET K=6 

uusg LET C$= "FUNZIONE SELEZIONATA €" 
GASO LET As=""" 

agcd DISP "SELEZIONA FUNZIONE (13 E BITLJI",, 
Ma?0 INPUT I. 

GASE DISP "INTRODUCI STRINGA", , 

A1699 INPUT F* 

GiaA LET B$E=A% . 

BITS CALL “"ASMOSI".I.I,E. AE 

1126 ON I+1 GOTO 136,170, 260, 356,444 
A136 PRINT CEI." ] STRINGA NULL" 

Hi AO GOSUB 568 

ATSO PRINT 

H164 GOTO 465 

Ai268 PRINT C&;I0" Dl TEST BIT; dJi"= 1" 


o] 


GOSUBE S84a 

ON E+1 GOTI 260,238 . 

PRIMT "IL BIT SELEZIONATO C"';4;” 1 NON D'OR 1" 
PRINT 

GOTO 460 

PRINT “IL BIT SELEZIONATO C“;4;" 3 E° R 1" 
PRINT 

GOTO 4656 

PRINT C$;1;" 1: SET BIT".;| 

GOSUB S06 

UN K+t1 GOTO 290,328 

PRINT *IL BIT"; $4;* E* STATO. SETIRTO" 
PRINT 

GOTO 460 

PRINT "IL BIT";4;" ERA GIR' SETTATO" 
PRINT 

GETO 4658 

PRINT C&;1;" IIRESET BIT ";J 

GOSUE 5606 

ON K+4 GOTO 350,416 

PRINT “IL BIT ";J;" ERA GIRÒ RESETTRIO". 


So DARE oGgaeAacieoro Mi 


CEI TOoOTTA 
N CA En n DI LOR I DD OL LT I) DI SI EURI ORI RI RI RI RI INI RI da a A LA I ea a i e n 


Dl Bi » (i gi DI | GIRI + (O LI DI Ton de Gi a I I Tin 


[6% MA" IE" POI SONE I E AP E E I PI E E I UE E AE E RI E I O I E NIE ET E O TT N 


FRINT 
(i; GOTO 4668 
la; PRINT “IL BIT". Jp ET SIRIO RESEPTRTO" 
Da) FRINT 
(5; GOTO 460. 
449 PRINT C$;/1;" 3}: STRINGA DELETE" 
f456 CcOSUB 546 
6455 PRINT 
d469 DISP “MUGUA FUNZIONE? SI=6",. 
5479 INFUT F 
44559 IF F=8 THEN 64 
1499 GOTO 535 
a546 PRINT "STRINGA INTRODOTTA: ";B£ 
510 PRINT “STRINGA RITORMOTA (G;H$ 
doza RETURN 
ASA END 
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Modulo Assembler 





AEIMOE 


PRE 
n (a 
asd ra 
n n 
fa 


EA 
A 


a o 
uni 

n © 
cal 
nt 


oa 
$ «Fe 
© m 
£ 1a 


em 
; 

sw — 

TAsC] 

Ki 

in 


Ù m 
= i 


A mi 
toi 
(ETA) 


FS 
RA 


mu 


è ao 
J 


pa 

Dal 
* 
LA 


Sio a 


n 
(Mb, RALE a RE STEP RI CI PORTO 


mu vo 


da 
«dati 








uo 


ibo( 
mdc 


SOUL 


Ù 
- 
î 
nei 
È 





= 
o 


lì 


SI [ra] 
hm in i ie i on i i 


vo op 
+ BI RI a La 
REATI 







dt) 


DITIOToana A 
Tal Cet def GIRI RO RI RI RI I rar 
tai A a SD I 0 






cm Rina i una e 





D 





(AURELIO 
n 
ANI 


De. 
hi i 
farti 





Us) Col fat de! 
Din 
* 





bp Cafe o 
Mato 4 ci 


THG1 
* 
LOOF 


ve 
iI 


Dix] 
Si o in a 


mo 
defi 
mio 


TRFUMN 


dé mn 
i oo 


+ D 
fai 


foi a ao 
vi i To i a 


Gi 
È 
“ 
$ 
+ 
4 
é 
$ 
4 
$ 
4 
4 
S 


ST Ab dd 4 Ti ina in 


START # MODULO BESEMELER FER FUNE. STRINGE 


PRI 

EU A 
Ea 1 
Eolt 2 
EGU 2 
EGL * 
Cono Ss 
EGLI E 
ERO 
Ego 
EG 3 


GALE Ra.a 
USING #3 
USING LOCAL, 13 

+6 PRELIEVO MUBRERO AEGOMENTI ds 
LE Rf. 
GEA Ra. RP 
CFL RS. 16 
SRL R4. È 

## CORTROLLO NUM, ARGOMENTI CORRETTO #* 

CH Ks,=H/S° 
ENE RIENTEOG 

40 PRELIEUO INDIRIZZO DI IU ** 
LA F&.4 
GSA Rasa 

44 PRELIENO INDIRIZZO DI Josx* 
LA REA 
GSH” R5,R5 

*$# PRELIEUO INDIRIZZO DI Ko x* 
LA R6, 2 
GER REL.RE 

#% PRELIEVO INDIRIZZO DESCRITTORE STRINGA AS 2" 
LS RP.1 
GSA RP.R7 
: *#* MENORIZZAZIONE NUM, CRT. DI HS ** 
MUC HALFA.BIRPI 
NI HALFA.&/ Wa - 
MUC INDC33),2CR7) 
L RPa.FULL * RP PUNTA ALLA STRINGA P$ 
#& CONVERSIONE CODICE FUNZIONE ÉÈI) E BIT DA DFERORE (041 #& 


CHST CRMPO.ACRS) 

CSEH HRLFI,CHMPO+1 08) 

CMST CRIAFU,.SCRS) 

CSB8H HALFJ,CAMPO+1C6] ; 
MUC As, R61, ZERO # REZERMMENTO DI KE 


$&& CONTROLLO FUNZIONE O #* 

GLI HBLFI+1.&/ 64° i 

ERE ALTRFUT 

LE RS, EZERI * R9 PUNTI LIF BYTE COM TUTTI I BIT=M 

LH RS.HALFX * RS CONTIENE IL RUN. DI CRT DI R$ 

#*# LOOP SOSTITUZIONE CRT STRINGA «* 

MUC 2C1,R7), 0 CRII 

BLEI FF.1 

BET RS. LOOP 

E RIENTEO 

LA RIUGUNI # R93 FUATA UN &ETE COH TUTTI 1 BIT=1 
4 CONTROLLO FUNZIOHE 4 #% 

CLI HRLFI+1.£' 998° 

BE TRGI 

LH RS. HALFJ 
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Modulo Assembler (segue) 
CESSI TIRI III IR CRAIISEIONIIESAAIAIRIZRIIZIZIZIAARI PI FIIAITROAE OT 


SRL RS.3 
AR R7,KR8 
LA RS? 
MAE RILRS 
LA RS.BTHE 
IC RE.GIRa»F93) 
Ea RE5.TESTRIT 
BO 2, GO0O0Nt 
MUo ars, Rel, Uso 
GUORA EDU * 
* #6 COMTROLLO FUNZIONE 1 ** 
CLI HALFI+1. 01” 
EE RIENTRO 
* 4% CONTROLLO FUNZIONE 
CLI HALFI+1,X 02° 
GE GOONZ 
* #* CONTRECLLO FUNZIONE 3 #*& 
CLI HBALFI+1,X°*&3* 
ENE ERRORE? 
LA RS. ANDTAS 
IC RS.,ACES,R91 
EX RE. RESET 
E RIENTRO 
GOONZ Ea RS.5ET 
E RIENTRO 
ERRORE: MUC G03,R6), DUE 
RIENTRO EQU # 


fi 


** 


TITTI a 


Dov 


DAL 
Tasca i n ni Se Du 


PERET 

DRG #72 

ER 14 
BZERI DE x 00° # BYTE CON TUTTI I EIT=6 
BLUNI DE R°'FF* * &NTE CON TUTTI I BIT=1 
ZERO DO x'ESGGIGdSIagago 10 * G IN DOPPIA FRECISIUNE 
UNO DO X'B19BOB0IGUONdI va #* 1 IN DOPPIA PRECISIONE 
DUE DÈ x'E20000006090 0030 * 2 IN DOPFPIR PRECISIONE 
BTRE DO $' 304620100504 0201* 
ANDTRE DC %' PFEFDFEFF FFEFDFE® 


DS BH S 
TESTBIT TM ZIE?) K/D0° 
RESET, NI 2 URP), 90° 


1AEACdIaAnrandAAGAAIaoarosiiri can 


ASD AE Alt gt tt e Ru ui ue 00 0 0 0 DI DI 0 N GI 0 4 SI HO 4 4 OT n ni Thi i Ti in en in in in in in 
ji bi + TI Vi ib do SIT LA I Cl hi (e I E e o a A TT © DO hi SDA a 


[10 i SI E O SIN 


SET DI 2 RP), Kad ; ; 

M * . i ** DEFINISIONE APREA LOCALE ** 
Da] LOCAL DRECT 

to) OLD12 GE F. 

Ds) FULL GS BF 

n3I4 DS CLI 

Gauaa IND DS CLI 

1960 HALFI CS H 

GIFO HALF. CS KH 

6354 HALFX DS H 

AIIS5 COMPO 05 CL? 

15859 ENDLOCAL CS MGF 
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Run del programma 





FIN 

Xi FORMALLY CORRECT FRUGRAM dose 

SELEZIONA FUNZIONE CI) E BITC(JI 

Ha. 

IMTRODUCI STRINGA 

12354567540 QWERTYUIOPASDFGHJIKLY2XCUBNM 

FUNZIONE SELEZIONATA C& 3: STRINGA NUL 

STRINGA INTRODOTTA: 1234567 5300WUERTYUIOFASDFGHIKLNZXCYUENM 
STRINGR RITORNATA | S4BS8ERNORBSESESBE RENDER NERSL RENEE 


HUOUA FUNZIONE? SI=SU 


n, 


1 
SELEZIONA FUNZIONE LCII E BITIJI 


ina 


Un 
dal 


INTRODUCI STRINGA 

SANTO 

FUNRZIONE SELEZIONATA C 10 3: TEST BIT 23 = | 
STRINGA INTROGOTTR:SANTO 

STRINGA RITOERNATA (SANTO 


IE. ‘BIT SELEZIONATO i 233 “IE” Rd 
NUOVA FUNZIONE? SI=6 

SELEZIONA FUNZIONE CI) E BITCJI) 
imcapie, STRINGA 

SANTO 


FUNZIONE SELEZIONATA C 41 3: TEST BIT 11 = 1 
STRINGR INTRODOTTA:SANTO 

STRINGR RITORNATA (SANTO 

IL BIT SELEZIONATO € 191) MON E° A 1 


MUOVA FUNZIONE? 5I=9 

d | 

SELEZIONA FUNZIONE CII E BITLJ) 

2,446 A 

INTRODUCI STRINGA 

SANTO ' 

FUNZIONE SELEZIONATA € 2 1: SET BIT 146 
STRINGA INTRODOTTA :SANTO 

STRINGA RITORNATA :SENTO 

IL BIT 14. E* STRATO SETTATO 





| 
Hi 
| 


VA FUNZIONE? SI=5 


DZ 
CC 
Cin 


PE LEZIONA FUNZIONE CI) E BITCJI) 

Za 8 

IMTRODUCI STRINGA 

SANTO: . 

FUNZIONE SELEZIONATA € 2 1: SET BIT 36 
STRINGA INTRODOTTA :SANTO 
STRINGA RITORNATA SANTO 

IL BIT 38 ERA GIR’ SETTATO 
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Run del programma (segue) 





MUOVA FUNZIONE? SI=b 

n 

SELEZIONA FUNZIONE CI) £ BITIHI 

EI 

INTRODUCI STRINGA 

SENTO 

FUASIOHE SELEZIONATE € 3 J/RESET BIT 4& 
STRINGA INTRODOTTA: SANTO 

STRINGA RITORNATA CCRNTO 

IL BIT 4 E° STATO RESETTATO 

HUOVA FUNZIONE? 5I=6 

Et 

SELEZIONA FUNZIONE CII E BITL4I) 

Za 19 

INTRODUCI STRINGA 

SANTO . 
FUNZIONE SELEZIONATA I 3 ]9:RESET BIT 19 
STRINGA INTRODOTTA (SANTO 

STRINGA RITORNATR (SANTO 

IL BIT 19 ERA GIR° RESETTRTO 


MUGUA FUNZIONE? SI=@ 
Da 
SELEZIONA FUNZIONE (1) E BITCI) È 


4, 0 

IMTRODUCI STRINGA 

123456 ?75900YERTYUIOPRSDFGHIKLZ#CUBNM 

FUNZIONE SELEZIONATA Co 4 1: STRINGA DELETE 

STRINGA INTRODOTTA: 12 ‘34567 8900WERTYUIOPASDFGHJKLYZMCUBNM 
STRIIGRO RI TURISATA ICH IEE GO AN GIO AGG OG KILAAG VEL AGG 808 OE HOU I VKC TGO VAN DEF ARO GAS AGE DAG GA GIO TRE ALARE OI L06 S6LHEIAI 
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